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版 权 声 明 
本 书 的 著作 权 为 作者 (HYRY Studio) 所 有 。 你 可 以 : 


。 下载、 保存 以 及 打印 本 书 

。 网 络 链接 、 转 载 本 书 的 部 分 或 者 全 部 内 容 ， 但 是 必须 在 明显 处 提供 读者 访问 本 
书 发 布 网 站 的 链接 

。 在 你 的 程序 中 任意 使 用 本 书 所 附 的 程序 代码 ， 但 是 由 本 书 的 程序 所 引起 的 任何 
问题 ， 作 者 不 承担 任何 责任 


你 不 可 以 : 


。 以 任何 形式 出 售 本 书 的 电子 版 或 者 打印 版 

。 擅自 印刷 、 出 版 本 书 

。 以 纸 媒 出 版 为 目的 ， 改 字 、 改 编 以 及 摘抄 本 书 的 内 容 

° d 毕业 设计 以 及 作业 中 大 段 摘抄 本 书 文字 ， 或 直接 使 用 本 书 的 程序 
-a 


使 用 说 明 

本 书 使 用 reStructuredText 编 写 ， 采 用 Sphinx 发 布 。 在 此 基础 上 添加 了 评论 功能 ， 你 
可 以 在 hyry.dip.jp 的 在 线 版 本 中 点 击 章节 标题 前 面 的 评论 按钮 ， 对 每 个 章节 进行 评 
论 。 推 荐 使 用 IE7.0 以 上 、FireFox、Google Chome 等 浏览 器 阅读 本 书 。 

本 书 有 两 个 镜像 地 址 : 


e http://hyry.dip.jp/pydoc (每 日 更 新 ) 
e http://pyscin.appspot.com/html/index.htm! (每 周 更 新 ) 


请 使 用 下 面 的 链接 下 载 各 种 打包 版 本 ， 其 中 Html 打 包 版 本 格式 最 为 正确 ，CHM 和 
PDF 版 都 多 少 有 些 问题 。 


下 载 Html 打 包 版 下 载 CHM 版 下 载 PDF 版 下 载 源 代码 

另外 ， 你 还 可 以 通过 Google 文 档 和 ZoomQuiet.org( 国 内 下 载 快速 ) 下 载 PDF 版 本 
请 查看 最 近 更 新 了 解 最 新 添加 的 内 容 

天 于 HYRY Studio 


e HYRY Studio 首 页 : http://hyry.dip.jp 
e 博客 地 址 : http://hyry.dip.jp/blogt.py 


Python 是 一 种 面向 对 象 的、 动态 的 程序 设计 语言 。 具 有 非常 简洁 而 清晰 的 语法 ， 适 


合 于 完成 各 种 高 层 任务 。 它 既 可 以 用 来 快速 开发 程序 脚本 ， 也 可 以 用 来 开发 大 规模 
的 软件 。 


随 着 NumPy, SciPy Matplotlib, Enthought librarys 等 众多 程序 库 的 开发 ，Python 越 
来 越 适 合 于 做 科学 计算 、 绘 制 高 质 量 的 2D 和 3D 图 像 。 和 科学 计算 领域 最 流行 的 商 
业 软 件 Matlab 相 比 ，Python 是 一 门 通用 的 程序 设计 语言 ， 比 Matlab 所 采用 的 脚本 语 
言 的 应 用 范围 更 广泛 ， 有 更 多 的 程序 库 的 支持 。 虽 然 Matlab 中 的 许多 高 级 功能 和 

toolbox 目 前 还 是 无 法 替代 的 ， 不 过 在 日 常 的 科研 开发 之 中 仍然 有 很 多 的 工作 是 可 以 
用 Python 代 劳 的 。 


本 书 将 介绍 如 何 用 Python 开发 科学 计算 的 应 用 程序 ， 除 了 介绍 数值 计算 之 外 ， 我 们 
还 将 着 重 介绍 如 何 制作 交互 式 的 2D、3D 图 像 ; 如 何 设计 精巧 的 程序 界面 ; 如 何 和 C 
语言 所 编写 的 高 速 计算 程序 结合 ; 如 何 编写 声音 、 图 像 处 理 算法 。 


阅读 本 书 你 需要 学 习 过 Python 语言 的 一 些 基 础 知识 ， 对 面向 对 象 的 程序 开发 有 所 了 
解 。 有 关 Python 话 言 基础 的 知识 ， 可 以 参考 : 


呼 木 乌 社区 的 Python 图 书 概览 : http://wiki.woodpecker.org.cn/moin/PyBooks 


本 书 中 的 所 有 示例 均 在 Windows XP 系统 下 采用 Python(x,y) 通 过 测试 。 如 果 你 觉得 
安装 众多 的 Python 程序 库 很 麻烦 ， 不 妨 下载 安 装 Python(x,y)。 请 阅读 : 软件 包 的 安 
装 和 介绍 


基础 篇 


科学 计算 所 用 到 的 各 种 库 的 入 门 介绍 


o 软件 包 的 安装 和 介绍 
o 安装 软件 包 
o WME TZ 
e NumPy- 快 速 处 理 数 据 
o ndarray 对 象 
o ufunc 运 算 
o 矩阵 运算 
o 文件 存 取 
e。 SciPy- 数 值 计算 库 
o 最 小 二 乘 拟 合 
o KHAA 
非 线 性 方程 组 求解 
B-Spline 样 条 曲线 
数值 积分 
解 常 微分 方程 组 
滤波 器 设计 
用 Weave 散 人 C 语 言 
e SymPy- 符 号 运算 好 帮手 
o 封面 上 的 经 典 公式 
o 球体 体积 
matplotlib- 绘 制 精美 的 图 表 
o 快速 绘图 
o 绘制 多 轴 图 
o 配置 文件 
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o Artist 对 象 
° mm -为 Python 深 加 类 型 定义 
背景 
o Traits 是 什么 
(o) 动态 添加 Trait 属 性 
o Property 
o Trait 属 性 监听 
e TraitsUl- 轻松 制作 用 户 界面 
o RBA 
o RELA 
o 配置 视图 
e Chaco- 交 互 式 图 表 
o 面向 脚本 绘图 
o 面向 应 用 绘图 
。TVTK- 三 维 可 视 化 数据 
o TVTK 使 用 简介 
o TVTK 的 改进 
e Mayavi- 更 方便 的 可 视 化 
o 用 mlab 快 速 绘图 
o Mayavi 应 用 程序 
o 将 Mayavi 藤 入 到 界面 中 
e Visual- 制 作 3D 演 示 动 画 
o 场景 、 物 体 和 照相 机 
o 简单 动力 
o 盒子 中 反弹 的 球 
© OpenCV- 图 像 处 理 和 计算 机 视觉 
o 读 写 图 像 和 视频 文件 


手册 篇 
各 个 库 的 用 户 使 用 手册 的 翻译 
e Traits 使 用 手册 
o traits 
o traits.ui 


@ Visual 使 用 手册 
o 场景 窗口 


用 所 学 到 的 东西 解决 实际 问题 


。 声音 的 输入 输出 
o 读 写 Wave 文件 
o 用 pyAudio 播 放 和 录音 
o 用 pyMedia 播 放 Mp3 
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e 数字 信号 系统 
FIR 和 IIR 滤 波 器 
FIR 滤 波 器 设计 
IR 983 asi it 
滤波 器 的 频率 响应 
二 次 均衡 器 设计 工具 
e FFT 演 示 程 序 
o FFT 知 识 复习 
o 合成 时 域 信号 
o 三 角 波 FFT 演 示 程 序 
eo 频 域 信号 处 理 
o 观察 信号 的 频谱 
o 快速 众 积 
o Hilbert 变换 
e Ctypes 和 NumpPy 
o 用 ctypes 加 速 计算 
o 用 ctypes 调 用 DLL 
o numpy 对 ctypes 的 支持 
自 适应 滤波 器 和 NLMS 模 拟 
自 适应 滤波 器 简介 
NLMS 计 算 公式 
NumPy 实 现 
DLLEW BNA 5 
ctypes 的 python 接 口 
单 摆 和 双 摆 模拟 
o 单 摆 模 拟 
o 双 摆 模拟 
分 形 与 混沌 
o Mandelbrot 集 合 
o ARKA RA (IFS) 
o L-Systema i 
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附录 


e 天 于 本 书 的 编写 
o 本 书 的 编写 工具 
o 问题 与 解决 方案 
o ReST 使 用 心得 
o 未 解决 的 问题 
e 最 近 更 新 


源 程 序 集 


。 源 程序 集 
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软件 包 的 安 季 和 介绍 


安 委 软 件 包 
RR 


和 Matlab 不 同 ，Python 的 科学 软件 包 由 众多 的 社区 维护 和 发 布 ， 因 此 要 一 一 将 其 收 
集 齐 安装 到 你 的 电脑 里 是 一 件 很 费时 间 的 事情 。 盏 好 这 些 工作 已 经 有 人 帮 我 们 整理 
好 了 。 只 需要 下 载 一 个 文件 ， 一 次 安装 就 能 拥有 众多 的 汞 数 库 可 供 使 用 。 


这 里 介绍 两 个 科学 计算 Python 合集 的 下 载 和 安装 过 程 。 


Python(x,y) 
http://www.pythonxy.com & #AyPython(x,y)$4i400M, WE T ASHRAM ELL 
文档 、 教 程 。 并 且 提 供 了 一 个 方便 的 启动 界面 : 


@ Python&.y) Home -|0| x| 


rad python(x,y) 
2.1.14 


Shortcuts | Documentation | about | 






































Q Python&.y) Home -10| x|| <> Python&.y) Home -lol x| 


Kj al 
X python(x,y) 
5 2.1.14 


RW python(x,y) 
2.1.14 
Shortcuts [Documentation ]| About | Shortcuts | Documentation About” 
General documentation: 
[E Documentation Folder =| v | 
m Python modules 一 一 一 一 
[Sc ientific X | 
numpy 
scipy 
numexpr 
sympy ‘symbolic maths) 


cyxopt 
NetworkX 


Applications: (Eclipse, Qt, Mayai 


| S Eclipse >| ~ | 
Pydee: 
Options : [~-a >| &l 


Interactive consoles: 


[E Python) =| B| 


TPythont&,y) 


Startup script: 8 | 
[default py -| 
A | 


5) | Logging folder 


Python&y) 2.1.14 Python 2.5.4 





Installed plugins 






CDT 5.0.1 
Cython 0.11.2 
EnthoughtToolSuite 3.2.0.1 



























Remove plugins | ĝ | 














Python(x,y) 的 和 启动 画面 


e Shortcuts : 启动 各 种 应 用 程序 
e Documentation : 打开 各 个 软件 包 的 文档 
e About : 查看 所 安装 的 程序 库 的 版 本 信息 


Enthought Python Distribution (EPD) 


下 载 地 址 : http://www.enthought.com/products/getepd.php EPD 是 一 个 商业 的 
Python 发 行 版 本 ， 同 祥 包 括 了 众多 的 科学 软件 包 ， 而 且 作 为 教学 使 用 是 免费 的 ， 大 
小 约 为 250M。 


工具 
装 好 了 之 后 先 看 看 下 面 这 些 常用 的 工具 ， 在 以 后 的 学 习 过 程 中 会 经 常用 到 。 


对 


iPython 


ipython 是 一 个 python 的 交互 式 shell， 比 默认 的 python shell 好 用 得 多 ， 支 持 变 量 
自动 补 全 ， 自 动 缩 近 ， 支 持 bash shel 命令 ， 内 置 了 许多 很 有 用 的 功能 和 本 数 。 


如 果 你 安装 了 Python(x,y) 的 话 ， 可 以 从 Python(x,y) 的 启动 界面 中 运行 iPython。 
过 Python(x.y) Home me x 


RM python(x,y) 
2.1.14 


Shortcuts | Documentation | About | 





Applications: ‘Eclipse, Qt, Mayai) 


E Eclipse "| v | 
Pydee: 


Options : -a = | 


Interactive consoles: @ D 


[Fynont. d J 国 | 
ra [Pythons 
= IPython OD 

e IPython wxPython) 
e IPython tmlab) 

e Python 


Bl Logging folder 3) 




















通过 Python(x,y) Home 和 启动 |Python 的 各 种 选项 


从 下 拉 选 择 框 中 选择 你 想 运行 的 iPython， 然 后 点 击 后 面 的 @ 或 者 @ 按 钮 启动 
iPython。 下 拉 选 择 框 中 的 IPython(x,y)、IPython(Qt)、IPython(wxPython) 和 
IPython(mlab) 等 几 个 选项 都 是 启动 iPython， 只 不 过 它们 的 启动 方式 不 同 。 而 
Python 选 项 则 只 启动 单纯 的 Python Shell. 


选项 参数 BL 
IPython(x,y) -pylab -p xy 
IPython(Qt) -q4thread 
IPython(wxPython) -wthread 
IPython(mlab) -wthread 


点 击 @@ 按 钮 将 用 一 个 叫做 Console 的 软件 启动 Shell， 此 软件 在 窗口 中 显示 Shell， 并 
且 支 持 多 标签 。 点 击 @ 按 钮 用 Windows 自 带 的 Cmd 和 启动 Shell。 


如 果 你 用 python(x,y) 的 启动 界面 通过 IPython(x,y) 运 行 iPython 的 话 ， 那 么 在 iPython 
打开 之 后 自动 运行 一 个 default.py 肢 本。 此 脚本 缺 省 执行 以 下 的 函数 库 导 入 : 


import numpy 
import scipy 
from numpy import * 


为 了 和 numpy, scipy 等 社区 的 推荐 的 标准 导入 方式 一 致 ， 请 点 击 按钮 @， 然 后 在 打 
开 的 文件 夹 中 添加 一 个 名 为 humpy.py 的 文件 ， 编辑 此 文件 ， 添加 以 下 几 行 推荐 的 导 
人 : 


import numpy as np 
import scipy as sp 
import pylab as pl 


此 后 运行 |Python(x,y) 的 时 候 请 记 着 要 选择 numpy.py 为 启动 脚本 。 


如 果 要 使 用 pylab，TraitsUl 等 在 shell 中 和 图 形 界面 进行 交互 的 话 ， 需 要 选择 带 - 
wthread 参 数 的 选项 (-pylab 也 可 以 )。 下 图 是 一 个 用 pylab 绘 制 sin 波 形 图 的 例子 


Pyt hon(x, y) 2.1.14 profile startup ET 
Loading NumPy Ml Fisure 
Loading Seamy 
Importing all Numpy functions, EEC: ,| | 
Logging to C:\Program Fi les\pythonxy\logs\2009-07 





Python 2.5.4 (r254: 67916, Dec 23 2008, 15:10:54) [ 
Type "copyright", "credits" or "license" for more 


IPython 0.9.1 -- An enhanced Interactive Python. 
-> Introduction and overview of IPython' 
Kavickref -> reference. 
p -> Python's own hel system. 
object? -> Details about "ohio ?object also v 


IPython profile: xy 


Welcome to pylab, a matplot]ib-based pm envi 
For more information, type ‘help(pylab 





x = linspace(0,4*pi,100) 


plot(x,sin(x)) 
[<matplotlib.lines.Line2D object at Ox0COFEDBO>] 





使 用 IPython 交 互 式 地 绘制 正弦 波 
在 iPython 的 交互 中 可 以 方便 地 使 用 如 下 功能 : 
e。 自动 补 全 : 输入 一 部 分 文字 之 后 按 tab 键 ，iPython 将 列 出 所 有 以 输入 补 全 信 


。 查看 文档 : 输入 需要 查看 文档 的 画 数 ， 然 后 在 后 面 添 加 ?或 者 ??，? 表 示 查 看 萎 
数 的 文档 ，?? 表 示 查 看 其 Python 源 代码 ， 如 果 画 数 不 是 Python 写 的 ， 则 查看 不 
到 。 

e 执行 cmd 命 令 : ls- 列 出 当前 目录 下 的 所 有 文件 ，cd- 显 示 或 者 更 改 当 前 路 径 

e 执行 Python 程序 : 用 run *.py 命 令 ， 在 IPython 中 运行 指定 的 py 文件 。 如 果 加 -i 
参数 的 话 ， 则 在 IPython 的 命名 空间 中 执行 。 也 就 是 说 在 文件 中 没有 定义 名 称 会 
直接 使 用 在 IPython 中 的 。 

e 执行 剪 切 板 中 的 程序 : 你 可 以 从 本 书 中 复制 代码 ， 然 后 在 IPython 命 令 窗 口中 执 
行 paste 命 邻 运行 复制 的 代码 。 如 果 执 行 paste foo 的 话 ， 将 把 剪 切 板 中 的 内 容 
复制 到 变量 foo 中 。 变 量 foo 是 一 个 IPython 提 供 的 SList 列 表 类 型 ， 它 提供 了 很 多 
操作 所 复制 的 内 容 的 方法 。 

e 执行 系统 命令 : 在 要 执行 的 系统 名 字 之 前 添加 一 个 ! 号 。 例 如 执行 !test.py 的 
话 ， 那么 将 让 系统 运行 test.py 文 件 。 和 run 命 邻 不 同 的 是 ，test.py 完 全 在 另外 的 

进程 中 运行 。 


spyder 


spyder 是 Python(x,y) 的 作者 为 它 开发 的 一 个 简单 的 Python 开发 环境 。 和 其 它 Python 
IDE 相 比 它 最 大 的 优点 就 是 模仿 MATLAB 的 workspace 功 能 ， 可 以 很 方便 地 观察 和 修 
改 数组 的 值 。 


spyder 的 项 目地 址 : http://code.google.com/p/spyderlib 
下 图 是 spyder 的 界面 截图 : 
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Ée gót lwch owce jhmectve consoe Wirhapece External cormcte yiee net ?了 





ae ns s hed hed $43 oae- TE ew FA o minere & D CEP thon Tew ete pack seest -六 个 
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| J Spyder Editor 
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S This tesporery script file is leceted here 
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. 

9 import pylad əs pl 
A ie 1 = sp. lensi) 

1i pl. beshow(1, cmap-pl.c#. grey) 
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13 pl. figure() epre Pinne 
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Options; isport (sys, tise, re, os, Os.peth as osp), isport eumpy #5 
np, import scipy a5 sp, isport satpletlib ss spl, isport 
satplotlib.pyplot as pit, fros pyleb isport * 


>>> emecfile(u'C; \\Wsers\\2hang\\. spyder\\, tep. py’) 
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FaæÆWorkspacekj# a, 7E TRANS SAURKEMAY SER. RA 
可 以 显示 出 操作 指定 变量 的 菜单 : 


Warning 


Workspace 缺 省 配置 不 显示 大 写字 母 开 头 的 变量 ， 可 以 在 Workspace 菜 单 中 修改 这 
项 配置 。 


® Spyder (ail) a 
File Edit Search Sowce Interactive console Workspace Extemal console View Tools ? 
| 3 ® » ki» ê» EP E» 9b» EE > Working drectory » 
| | Workspace ~ temp ws ox 

Name Type Size Value 


Min: 
1 nt32 (512 512) axe 

























r float64 (1000) 
此 
Min: . 
; fod (100) ues 1,0 图 
= Show image 
= Insert 
_ Copy 
E Paste 
[ Doc [oWorkepace=empwes Fileeplorer | Findmiies | Pl @ Remove 
Interactive console 四 A 





-0.38472241, -0.39496415, -8.40095376, -0.40275 “Duplicate 
-@.39417246, -0.38408323, -0.37036864, -0.35324 
-@.30976607, -@.2839627 , -@.25585048, -@.22574 
-@.16091667, -@.12687306, -@.@9220966, -0.05727 Always edit in-place 

@.01203057, @.@4573474, @.07838022, @.10966 Show collection contents 
@.16704398, @.1926325 , @.21585707, @.23652 Show arraye min/max 


External console | Interactive console History log 


Permissions RW Encoding: UTF-8 Line 1 Column 1 


MY Truncate values 





软件 包 的 安装 和 介绍 13 


FA Python 做 科学 计算 


使 用 Workspace 坦 看 变量 内 容 
选择 Plot 选 项 ， 将 出 现 如 下 图 所 示 的 绘图 窗口 : 


TOO +r G87 














使 用 数组 编辑 器 查看 和 编辑 数组 内 容 


函数 库 介 绍 


Python 的 科学 计算 方面 的 内 容 由 许多 库 构 成 ， 在 基础 篇 中 让 我 们 首先 来 了 解 一 下 编 
写 科 学 计算 软件 时 经 常 使 用 的 一 些 库 。 


数值 计算 库 
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NumPy 为 Python 提供 了 快速 的 多 维 数组 处 理 的 能 力 ， 而 SciPy 则 在 NumPy 基 础 上 
添加 了 众多 的 科学 计算 所 需 的 各 种 工具 包 ， 有 了 这 两 个 库 ，Python 就 有 几乎 和 
Matlab 一 样 的 义理 数据 和 计算 的 能 力 了 。 


NumPy 和 SciPy 官 方 网 址 : http://www.scipy.org 


NumPy 为 Python 带 来 了 真正 的 多 维 数 组 功能 ， 并 且 提 供 了 丰富 的 函数 库 处 理 这 些 数 
组 。 它 将 常用 的 数学 函数 都 进行 数组 化 ， 使 得 这 些 数 学 函数 能 够 直接 对 数组 进行 操 
作 ， 将 本 来 需要 在 Python 级 别 进行 的 循环 ， 放 到 C 语 言 的 运算 中 ， 明 显 地 提高 了 程 
序 的 运算 速度 。 
SciPy 的 核心 计算 部 分 都 是 一 些 久 经 考验 的 Fortran 数 值 计 算 库 ， 例 如 : 

eo 线性 代数 使 用 LAPACK 库 

o 快速 傅立叶 变换 使 用 FFTPACK 库 

。 常 微分 方程 求解 使 用 ODEPACK 库 

e 非 线性 方程 组 求解 以 及 最 小 值 求解 等 使 用 MINPACK 库 
符号 计算 库 


SymPy 是 一 套 进 行 符号 数学 运算 的 Python 函 数 库 ， 哩 然 它 目前 还 没有 到 达 1.0 版 
本 ， 但 是 已 经 足够 好 用 ， 可 以 帮助 我 们 进行 公式 推导 ， 进 行 符号 求解 。 


SymPy 官 方 网 址 : http://code.google.com/p/sympy 

界面 设计 

制作 界面 一 直 都 是 一 件 十 分 复 条 的 工作 ， 使 用 Traits 库 ， 你 将 再 也 不 会 在 界面 设计 
上 耗 炎 大 量 精力 ， 从 而 能 把 注意 力 集中 到 如 何人 处理 数据 上 去 。 

Traits 官 方 网 址 : http://code.enthought.com/projects/traits 


Traits 库 分 为 Traits 和 TraitsUI 两 大 部 分 ，Traits 为 Python 添加 了 类 型 定义 的 功能 ， 使 
用 它 定义 的 traits 属 性 具有 初始 化 、 校 验 、 人 代理、 事件 等 诸多 功能 。 


TraitsUl 库 基于 Traits 库 ， 使 用 MVC 结 构 快 速 地 定义 用 户 界面 ， 在 最 简单 的 情况 下 ， 
你 甚至 不 需要 写 一 句 关 于 界面 的 代码 ， 就 可 以 通过 traits 属 性 定义 获得 一 个 可 以 工作 
的 用 户 界 面 。 使 用 TraitsUl 库 编写 的 程序 自动 支持 wxPython 和 pyQt 两 个 经 典 的 界面 
库 。 


绘图 与 可 视 化 

Chaco 和 matplotlib 是 很 优秀 的 2D 绘 图 库 ，Chaco 库 和 Traits 库 紧密 相连 ， 方 便 制 
作 动 态 交 互 式 的 图 表 功 能 。 而 matplotlib 库 则 能 够 快速 地 绘制 精美 的 图 表 、 以 多 种 格 
式 输出 ， 并 且 带 有 简单 的 3D 绘 图 的 功能 。 

Chaco 官 方 网 址 : http://code.enthought.com/projects/chaco 

matplotlib 官 方 网 址 : http://matplotlib.sourceforge.net 


TVTK 库 在 标准 的 VTK 库 之 上 用 Traits 库 进 行 封装 ， 如 果 要 在 Python 下 使 用 VTK， 用 
TVTK 是 再 好 不 过 的 选择 。 Mayavi2 则 在 TVTK 的 基础 上 再 添加 了 一 套 面向 应 用 的 方 
便 工 具 ， 它 既 可 以 单独 作为 3D 可 视 化 程序 使 用 ， 也 可 以 快速 地 嵌入 到 用 户 的 程序 中 
去 。 


Mayavi2 官 方 网 址 : http://code.enthought.com/projects/mayavi 
VTK(Visualization Toolkit) 


视觉 化 工具 画 式 库 (VTK, Visualization Toolkit) 是 一 个 开放 源码 ， 跨 平台 、 支 援 
平行 处 理 (VTK 便 用 于 义理 大 小 近乎 1 个 Petabyte 的 资料 ， 其 平台 为 美国 Los 
Alamos 国 家 实验 室 所 有 的 具 1024 个 义理 器 之 大 型 系统 ) ABBE AWE. 2005 
年 实 全 被 美国 陆军 研究 实验 室 用 于 即时 模拟 俄罗斯 制 反 导弹 战 车 ZSU23-4 受 到 平面 
波 攻击 的 情形 ， 其 计算 节点 高 达 2.5 兆 个 之 多 。 -- 摘自 维基 百科 


此 外 ， 使 用 Visual 库 能 够 快速 、 方 便 地 制作 3D 动 画 演示 ， 使 你 的 数据 结果 更 有 说 服 


o 


Visual 官 方 网 址 : http://vpython.org 


图 像 处 理 和 计算 机 视觉 


OpenCV 是 由 英特尔 公司 发 起 并 参与 开发 ， 以 BSD 许 可 证 授权 发 行 ， 可 以 在 商业 和 
研究 领域 中 免费 使 用 。OpenCV 可 用 于 开发 实时 的 图 像 处 理 、 计 算 机 视觉 以 及 模式 
识别 程序 。OpenCV 提 供 的 Python API 方 便 我 们 快速 实现 算法 ， 查 看 结果 并 且 和 其 
它 的 库 进 行 数据 交换 。 


NumPy- 快 速 义理 数 气 


标准 安装 的 Python 中 用 列表 (list) 保 存 一 组 值 ， 可 以 用 来 当 作 数组 使 用 ， 不 过 由 于 列 
表 的 元 素 可 以 是 任何 对 象 ， 因 此 列表 中 所 保存 的 是 对 象 的 指针 。 这 样 为 了 保存 一 个 
简单 的 [1,2,3]， 需 要 有 3 个 指针 和 三 个 整数 对 象 。 对 于 数值 运算 来 说 这 种 结构 显然 比 
较 浪 费 内 存 和 CPU 计算 时 间 。 


此 外 Python 还 提供 了 一 个 array 模 块 ，array 对 象 和 列表 不 同 ， 它 直接 保存 数值 ， 和 C 
语言 的 一 维 数 组 比较 类 似 。 但 是 由 于 它 不 支持 多 维 ， 也 没有 各 种 运算 函数 ， 因 此 也 
不 适合 做 数值 运算 。 


NumPy 的 诞生 弥补 了 这 些 不足 ，NumPy 提 供 了 两 种 基本 的 对 象 : ndarray (N- 
dimensional array object) 和 ufunc (universal function object) 。ndarray( 下 文 统 
一 称 之 为 数组 ) 是 存储 单一 数据 类 型 的 多 维 数组 ， 而 ufunc 则 是 能 够 对 数组 进行 处 理 
的 函数 。 


ndarray 对 象 


函数 库 的 导入 
本 书 的 示例 程序 假设 用 以 下 推荐 的 方式 导入 NumPy 范 数 库 : 


import numpy as np 


创建 
首先 需要 创建 数组 才能 对 其 进行 其 它 操作 。 


我 们 可 以 通过 给 array 本 数 传递 Python 的 序列 对 象 创 建 数组 ， 如 果 传 递 的 是 多 层 艇 套 
的 序列 ， 将 创建 多 维 数组 (下 例 中 的 变量 c): 


>>> a = np.array([1, 2, 3, 4]) 

>>> b = np.array((5, 6, 7, 8)) 

>>> c = np.array([[1, 2, 3, 4],[4, 5, 6, 7], [7, 8, 9, 10]]) 
>>> b 

array([5, 6, 7, 8]) 

>>> TG 


array([[1, 2, 3, 4], 
[4, 5, 6, 7], 
[7, 8, 9, 10]]) 
>>> c.dtype 
dtype(‘'int32' ) 


数组 的 大 小 可 以 通过 其 shape 属 性 获得 : 


>>> a.shape 
(4, ) 

>>> c.shape 
(3, 4) 


数组 a 的 shape 只 有 一 个 元 素 ， 因 此 它 是 一 维 数组 。 而 数组 c 的 shape 有 两 个 元 素 ， 
因此 它 是 二 维 数 组 ， 其 中 第 0 轴 的 长 度 为 3， 第 1 轴 的 长 度 为 4。 还 可 以 通过 修改 数组 
的 shape 属 性 ， 在 保持 数组 元 素 个 数 不 变 的 情况 下 ， 改 变数 组 每 个 轴 的 长 度 。 下 面 
的 例子 将 数组 c 的 shape 改 为 (4,3)， 注 意 从 (3,4) 改 为 (4,3) 并 不 是 对 数组 进行 转 置 ， 而 
只 是 改变 每 个 轴 的 大 小 ， 数 组 元 素 在 内 存 中 的 位 置 并 没有 改变 : 


>>> c.shape = 4,3 
>>> C 
array([[ 1, 2, 3], 
[4 4) S], 
DS lene al 
[ 8, 9, 10]]) 


当 某 个 轴 的 元 素 为 -1 时， 将 根据 数组 元 素 的 个 数 自动 计算 此 轴 的 长 度 ， 因 此 下 面 的 
程序 将 数组 c 的 shape 改 为 了 (2,6) : 


>>> C,Shape = 2,-1 

>>> C 

array([[ 1， 2, 3, 4, 4, 5], 
Cer v m S 97, 104) 


使 用 数组 的 reshape 方 法 ， 可 以 创建 一 个 改变 了 尺寸 的 新 数组 ， 原 数组 的 shape 保 持 
RE: 


>>> d = a.reshape((2,2)) 
>>> d 
array([[1, 2], 
[3, 4]]) 
>>> a 
array([1, 2, 3, 4]) 


数组 a 和 d 其 实 共享 数据 存储 内 存 区 域 ， 因 此 修改 其 中 任意 一 个 数组 的 元 素 都 会 同时 
修改 另外 一 个 数组 的 内 容 : 


>>> a[1] = 100 # 将 数组 a 的 第 一 个 元 素 改 为 100 
>>> d # 注意 数组 d 中 的 2 也 被 改变 了 
array([[ 1, 100], 

[ 3, 4]]) 


数组 的 元 素 类 型 可 以 通过 dtype 属 性 获得 。 上 面 例子 中 的 参数 序列 的 元 素 都 是 整 
数 ， 因 此 所 创建 的 数组 的 元 素 类 型 也 是 整数 ， 并 且 是 32bit 的 长 整 型 。 可 以 通过 
dtype 参 数 在 创建 时 指定 元 素 类 型 : 


>>> np.array([[1, 2, 3, 4],[4, 5, 6, 7], [7, 8, 9, 10]], dtype=np.1 
array([[ 1., 2., , 4.], 

[ 4., Sop Ce ll; 

[ Vep Bop 9, 10.]]) 
>>> np.array([[1, 2, 3, 4],[4, 5, 6, 7], [7, 8, 9, 10]], dtype=np.¢ 
array([[ 1.+0.j, 2.40. ], 3.702, 4.+0.j], 

[ 4.+0.j, Seti, 6.+0.j, 7.+0.j], 

L vay 8.+0.j, 9.+0.j, 10.+0.j]]) 


[E E a a Se 
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做 显然 效率 不 高 。 因 此 NumPy 提 供 了 很 多 专门 用 来 创建 数组 的 函数 。 下 面 的 每 个 函 
数 都 有 一 些 关 键 字 参 数 ， 具 体 用 法 请 查看 函数 说 明 。 


earange 画 数 类 似 于 python 的 range 画 数 ， 通 过 指定 开始 值 、 终 值 和 步 长 来 创建 
一 维 数组 ， 注 意 数 组 不 包括 终 值 : 


3. 
7. 
0. 





>>> np.arange(0,1,0.1) 
array([ ©\. , 0.1, 0.2, 0.3, 0.4, 0.5, 0.6, 0.7, 


。 linspace Zut j EFA fit. 终 值 和 元 素 个 数 来 创建 一 维 数 组 ， 可 以 通过 
endpoint 关 键 字 指定 是 否 包括 终 值 ， 缺 省 设置 是 包括 终 值 





>>> np.linspace(0, 1, 12) 


array([ 0\. , ©.09090909, 0.18181818, 0.27272727, ©. 
©.45454545, ©.54545455, ©.63636364, ©.72727273, ©.81818182 
0.90909091, 1\. 1) 


«| — g 


logspace2Alllinspace #1, Pi EU EEA, FARBF = 41(1040) 
到 100(10^2)、 有 20 个 元 素 的 等 比 数列 : 





>>> np.logspace(0, 2, 20) 
array([ 1\. A 1.27427499, 1.62377674, 2.06912 
2.6366509 , 3.35981829, 4.2813324 , 5.45559478, 
6.95192796, 8.8586679 , 11.28837892, 14.38449888, 
18.32980711, 23.35721469, 29.76351442, 37.92690191, 

48 . 32930239, 61.58482111, 78.47599704, 100\. ]) 


‘| 








此 外 ， 使 用 frombuffer, fromstring, fromfie HAT LAM $ FF a) eRe, RL 
fromstring 4 l]: 


>>> s = "abcdefgh" 


Python 的 字符 串 实际 上 是 字 节 序列 ， 每 个 字符 占 一 个 字 节 ， 因 此 如 果 从 字符 串 s 创 
建 一 个 8bit 的 整数 数组 的 话 ， 所 得 到 的 数组 正好 就 是 字符 串 中 每 个 字符 的 ASCII 编 
码 : 


>>> np.fromstring(s, dtype=np.int8) 
array([ 97, 98, 99, 100, 101, 102, 103, 104], dtype=int8) 


如 果 从 字符 串 s 创 建 16bit 的 整数 数组 ， 那 么 两 个 相 邻 的 字 节 就 表示 一 个 整数 ， 把 字 
节 98 和 字 节 97 当 作 一 个 16 位 的 整数 ， 它 的 值 就 是 98*256+97 = 25185。 可 以 看 出 内 
存 中 是 以 little endian( 低 位 字 节 在 前 ) 方 式 保存 数据 的 。 


>>> np.fromstring(s, dtype=np.int16) 
array([25185, 25699, 26213, 26727], dtype=int1i6) 
>>> 98*256+97 

25185 


如 果 把 整个 字符 串 转 换 为 一 个 64 位 的 双 精 度 浮 点 数 数组 ， 那 么 它 的 值 是 : 


>>> np.fromstring(s, dtype=np. float) 
array([ 8.54088322e+194]) 


显然 这 个 例子 没有 什么 意义 ， 但 是 可 以 想象 如 果 我 们 用 C 语 言 的 二 进 制 方 式 写 了 一 
组 double 类 型 的 数值 到 某 个 文件 中 ， 那 们 可 以 从 此 文件 读 取 相应 的 数据 ， 并 通过 
fromstring 函 数 将 其 转换 为 float64 类 型 的 数组 。 


我 们 可 以 写 一 个 Python 的 函数 ， 它 将 数组 下 标 转换 为 数组 中 对 应 的 值 ， 然 后 使 用 此 
函数 创建 数组 : 


>>> def func(i): 
return 1%44+1 


>>> np.fromfunction(func, (10, )) 
2 A Os ee a 


fromfunction 了 芳 数 的 第 一 个 参数 为 计算 每 个 数组 元 素 的 函 数 ， 第 二 个 参数 为 数组 的 
大 小 (shape)， 因 为 它 支持 多 维 数 组 ， 所 以 第 二 个 参数 必须 是 一 个 序列 ， 本 例 中 用 
(10,) 创 建 一 个 10 元 素 的 一 维 数组 。 


下 面 的 例子 创建 一 个 二 维 数 组 表示 九 九 乘法 表 ， 输 出 的 数组 a 中 的 每 个 元 素 ali, j] 都 
等 于 func2(i, j) : 


>>> def func2(i, j): 
i return (i+1) * (j+1) 


>>> a = np.fromfunction(func2, (9,9)) 


>>> a 
array([[ 1., 2., 3., 4., 5., 6., T., 8., 9.], 
Din VARA Gor Gar Oa e or Oar l 
mee G o a er e A pode A 
E dor Bor Bar Gap 20a, Zor 2er 2a olly 
E Sa Dar e D 2 Da e O A 
L Ge er er Her Oa Oor Aar Ar Ay 
L Ver op Zilo Hor ep Mer Ao e Gel 
l 8a Gar Zr Aor ar Mar Oor Aap Wall; 
E Or a War or er Xor Cr Aar S) 
存 取 元 素 
数组 元 素 的 存 取 方 法 和 Python 的 标准 方法 相同 : 
>>> a = np.arange(10) 
>>> a[5] # 用 整数 作为 下 标 可 以 获取 数组 中 的 某 个 元 素 


5 

>>> a[3:5] # 用 范围 作为 下 标 获取 数组 的 一 个 切片 ， 包 括 a[3] 不 包括 a[5] 
array([3, 4]) 

>>> a[:5] # 省 略 开始 下 标 ， 表 示 从 a[0] 开 始 

array([0, 1, 2, 3, 4]) 

>>> a[:-1] # 下 标 可 以 使 用 负 1h, 表示 从 数组 后 往 前 数 

aGray( [Oy eds 2S) 4 65 vO ey 8 

>>> a[2:4] = 100,101 # Fine 不可 以 用 来 修改 元 素 的 值 

>>> a 

array([ 9, 1, pet 101, 4 5 6 7, 8, 9]) 
>>> a e e2] # 范围 中 的 第 三 个 参数 表示 步 状 ，2 表 示 隔 一 个 元 素 取 一 个 元 素 
array([ 1, 101, 57 7]) 

>>> af;:-1] # 省 略 范 人 EN 吉 束 下 标 ， 步 长 为 -1， 整 个 数组 头 尾 颠倒 
array([ 9, 8, 7, 5, 4, 101, 100, 1, 0]) 
>>> a[5:1:-2] # 步 长 为 =. 开始 下 标 必须 大 于 eB 

array([ 5, 101]) 


和 Python 的 列表 序列 不 同 ， 通 过 下 标 范 围 获取 的 新 的 数组 是 原始 数组 的 一 个 视图 。 
它 与 原始 数组 共享 同一 块 数据 空间 : 


>>> b = a[3:7] # 通过 下 标 范围 产生 一 个 新 的 数组 b，b 和 a 共 享 同 一 块 数据 空间 
>>> b 

array([101, 4, 5, 6]) 

>>> b[2] = -10 # 将 b 的 第 2 个 元 素 修 改 为 -10 

>>> b 

array([101, 4, -10, 6]) 

>>> a # a 的 第 5 个 元 素 也 被 修改 为 10 

array([ 0, 1, 100, 101, 4, -10, 6 7, 8, 9]) 


除了 使 用 下 标 范围 存 取 元 素 之 外 ，NumPy 还 提供 了 两 种 存 取 元 素 的 高 级 方法 。 
使 用 整数 序列 


当 使 用 整数 序列 对 数组 元 素 进 行 存 取 时 ， 将 使 用 整数 序列 中 的 每 个 元 素 作 为 下 标 ， 
Se ee 
享 数据 空间 。 


>>> x = np.arange(10,1, -1) 

>>> X 

array([10, 9, 8, 7, 6, 5 4 3, 2]) 

>>> x[[3, 3, 1, 8]] # 获取 x 中 的 下 标 为 3，3，1，8 的 4 个 元 素 ， 组 成 一 个 新 的 数 
array([7, 7, 9, 2]) 

>>> b = x[np.array([3,3,-3,8])] # 下 标 可 以 是 负数 

>>> b[2] = 100 

>>> b 

array([7, 7, 100, 2]) 

>>> x # 由 于 b 和 Xx 不 共享 数据 空间 ， 因 此 x 中 的 值 并 没有 改变 

abray( (10, S58, 7 e 5 A a’ a2 

>>> x[[3,5,1]] = -1, -2, -3 # 整数 序列 下 标 也 可 以 用 来 修改 元 素 的 值 
>>> X 

array (HOT =3, “6, -1, 6, -2, 4, 3, a 





使 用 布尔 数组 


当 使 用 布尔 数组 b 作 为 下 标 存 取 数 组 x 中 的 元 素 时 ， 将 收集 数组 x 中 所 有 在 数组 b 中 对 
应 下 标 为 True 的 元 素 。 使 用 布尔 数组 作为 下 标 获 得 的 数组 不 和 原始 数组 共享 数据 空 
间 ， 注 意 这 种 方式 只 对 应 于 布尔 数组 ， 不 能 使 用 布尔 列表 。 


>>> x = np.arange(5,0, -1) 

>>> X 

array([5, 4, 3, 2, 1]) 

>>> x[np.array([True, False, True, False, False])] 

>>> # 布尔 数组 中 下 标 为 9，2 的 元 素 为 True， 因 此 获取 x 中 下 标 为 9, 2 的 元 素 
array([5, 3]) 

>>> x[[True, False, True, False, False] ] 

>>> # 如 果 是 布尔 列表 ， 则 把 True 当 作 1， False 当 作 0， 按 照 整数 序列 方式 获取 x 中 的 元 
array([4, 5, 4, 5, 5]) 

>>> x[np.array([True, False, True, True]) ] 

>>> # 布尔 数组 的 长 度 不 够 时 ， 不 够 的 部 分 都 当 作 False 

array([5, 3, 2]) 

>>> x[np.array([True, False, True, True])] = -1, -2, -3 
>>> # 布尔 数组 下 标 也 可 以 用 来 修改 元 素 

>>> X 

array([-1, 4, -2, -3, 1]) 





4p RRR SFL FE, Mee wa MufuncwhHMs +, KFufuncwWR 


请 参照 ufunc 运 算 一 节 。 


>>> x = np.random.rand(10) # 产生 一 个 长 度 为 10， 元 素 值 为 9-1 的 随机 数 的 数组 
>>> X 

array([ 0.72223939, 0.921226 , 0.7770805 , 0.2055047 , 0.1756) 
0.95799412, ©.12015178, 0.7627083 , 0.43260184, 0.91379859] ) 
>>> x>0.5 

>>> # 数组 x 中 的 每 个 元 素 和 0 .5 进行 大 小 比较 ， 得 到 一 个 布尔 数组 ，True 表 示 x 中 对 应 区 

array([ True, True, True, False, False, True, False, True, Fal: 

>>> x[x>0.5] 

>>> # 使 用 x>0 .5 返回 的 布尔 数组 收集 x 中 的 元 素 ， 因 此 得 到 的 结果 是 x 中 所 有 大 于 0 .5 的 ; 

array([ 0.72223939, 0.921226 , 0.7770805 , 0.95799412, 0.7627( 
@.91379859] ) 


E 


多 维 数组 


多 维 数组 的 存 取 和 一 维 数组 类 似 ， 因 为 多 维 数组 有 多 个 轴 ， 因 此 它 的 下 标 需要 用 多 
个 值 来 表示 ，NumPy 采 用 组 元 (tuple) 作 为 数组 的 下 标 。 如 下 图 所 示 ，a 为 一 个 6x6 的 
数组 ， 图 中 用 颜色 区 分 了 各 个 下 标 以 及 其 对 应 的 选择 区 域 。 


组 元 不 需要 圆 括 号 


虽然 我 们 经 常 在 Python 中 用 圆 括 号 将 组 元 括 起 来 ， 但 是 其 实 组 元 的 语法 定义 只 需 
用 去 号 隔 开 即 可 ， 例 如 x,y=y,x 就 是 用 组 元 交换 变量 值 的 一 个 例子 。 








>>> a[@,3:5] 

array([3,4]) 

>>> al4:,4: ] 

array([[44,45],[54,55]]) 

>>> Sisal 

array([2,12,22,32,42,52]) 

Pom Bias tect cal 

array([[20,22,24], 
[40,42,44]]) 


使 用 数组 切片 语法 访问 多 维 数组 中 的 元 素 
如 何 创 建 这 个 数组 


你 也 许 会 对 如 何 创 建 a 这 样 的 数组 感到 好 奇 ， 数 组 a 实际 上 是 一 个 加 法 表 ， 纵 轴 的 值 
为 0, 10, 20, 30, 40, 50 ; 横 轴 的 值 为 0, 1, 2, 3, 4, 5。 纵 轴 的 每 个 元 素 都 和 横 轴 的 每 
个 元 素 求 和 ， 就 得 到 图 中 所 示 的 数组 a。 你 可 以 用 下 面 的 语句 创建 它 ， 至 于 其 原理 
我 们 将 在 后 面 的 章节 进行 讨论 : 





>>> np.arange(0, 60, 10).reshape(-1, 1) + np.arange(0, 6) 
array([[ 9, 1, 2, 3, 4, 5], 

[10, 11, 12, 13, 14, 15], 

[20, 21, 22, 23, 24, 25], 

[30, 31, 32, 33, 34, 35], 

[40, 41, 42, 43, 44, 45], 

[50, 51, 52, 53, 54, 55]]) 





>>> a[(0,1,2,3,4),(1,2,3,4,5)] 

array([1,12,23,34,45]) 

oP) Ei PA 

array([[30,32,35], 第 
[40,42,45], 6 
[50,52,55]]) sa | [30 [31 [32| 33 

>>> mask=np.array([1,0,1,0,0,1], 

dtype=np.bool) 
>>> a[mask,2] 
array([2,22,52]) 1 3h 


使 用 整数 序列 和 布尔 数组 访问 多 维 数组 中 的 元 素 


。 a[(0,1,2,3,4),(1,2,3,4,5)] : 用 于 存 取 数 组 的 下 标 和 仍然 是 一 个 有 两 个 元 素 的 组 
元 ， 组 元 中 的 每 个 元 素 都 是 整数 序列 ， 分 别 对 应 数组 的 第 0 轴 和 第 1 轴 。 从 两 个 
序列 的 对 应 位 置 取 出 两 个 整数 组 成 下 标 : a[0,1], a[1,2], ..., al[4,5]。 








e a[3:, [0, 2, 5]] : 下 标 中 的 第 0 轴 是 一 个 范围 ， 它 选取 第 3 行 之 后 的 所 有 行 ; 14h 
是 整数 序列 ， 它 选取 第 0, 2, 5 三 列 。 

e afmask, 2] : 下 标的 第 0 轴 是 一 个 布尔 数组 ， 它 选取 第 0，2，5 行 ; 第 1 轴 是 一 个 
整数 ， 选 取 第 2 列 。 


结构 数组 


在 C 语 说 中 我 们 可 以 通过 struct 关 键 字 定义 结构 类 型 ， 结 构 中 的 字段 占据 连续 的 内 存 
空间 ， 每 个 结构 体 占 用 的 内 存 大 小 都 相同 ， 因 此 可 以 很 容易 地 定义 结构 数组 。 和 C 
语言 一 样 ， 在 NumPy 中 也 很 容易 对 这 种 结构 数组 进行 操作 。 只 要 NumPy 中 的 结构 
定义 和 C 语 言 中 的 定义 相同 ，NumPy 就 可 以 很 方便 地 读 取 C 语 言 的 结构 数组 的 二 进 
制 数据 ， 转 换 为 NumPy 的 结构 数组 。 


假设 我 们 需要 定义 一 个 结构 数组 ， 它 的 每 个 元 素 都 有 name, age 和 weight 字 段 。 在 
NumPy 中 可 以 如 下 定义 : 


import numpy as np 

persontype = np.dtype({ 
"names':['name', 'age', 'weight'], 
ehonmmat Sy ly Sas aa) 

a = np.array([("Zhang",32,75.5), ("Wang",24,65.2)], 
dtype=persontype) 


我 们 先 创 建 一 个 dtype 对 象 persontype， 通 过 其 字典 参数 描述 结构 类 型 的 各 个 字段 。 
字典 有 两 个 关键 字 : names，formats。 每 个 关键 字 对 应 的 值 都 是 一 个 列表 。names 
定义 结构 中 的 每 个 字段 名 ， 而 formats 则 定义 每 个 字段 的 类 型 : 


。 S32 : 32 个 字 节 的 字符 串 类 型 ， 由 于 结构 中 的 每 个 元 素 的 大 小 必须 固定 ， 因 此 
需要 指定 字符 串 的 长 度 

e i: 32bit 的 整数 类 型 ， 相 当 于 np.int32 

e f: 32bit 的 单 精度 浮 点 数 类 型 ， 相 当 于 np.float32 


然后 我 们 调用 array 函 数 创 建 数 组 ， 通 过 关键 字 参 数 dtype=persontype， 指定 所 创 
建 的 数组 的 元 素 类 型 为 结构 persontype。 运 行 上 面 程序 之 后 ， 我 们 可 以 在 IPython 中 
执行 如 下 的 语句 查看 数组 a 的 元 素 类 型 


>>> a.dtype 
dtype([('name', '|S32'), (‘age', '<i4'), ('weight', '<f4')]) 


这 里 我 们 看 到 了 另外 一 种 描述 结构 类 型 的 方法 : 一 个 包含 多 个 组 元 的 列表 ， 其 中 形 
如 (字段 名 , 类 型 描述 ) 的 组 元 描述 了 结构 中 的 每 个 字段 。 类 型 描述 前 面 为 我 们 添加 
了 小 "<' 等 字符 ， 这 些 字符 用 来 描述 字段 值 的 字 节 顺序 : 


e |: 忽视 字 节 顺序 
e < :低位 字 节 在 前 
。 >: 高 位 字 节 在 前 


结构 数组 的 存 取 方式 和 一 般 数 组 相同 ， 通 过 下 标 能 够 取得 其 中 的 元 素 ， 注 意 元 素 的 
值 看 上 去 像 是 组 元 ， 实 际 上 它 是 一 个 结构 : 


>>> a[0] 

('Zhang', 32, 75.5) 

>>> a[0].dtype 

dtype([('name', '|S32'), ('age', '<i4'), ('weight', '<f4')]) 


a[0] 是 一 个 结构 元 素 ， 它 和 数组 a 共享 内 存 数 据 ， 因 此 可 以 通过 修改 它 的 字段 ， 改 变 
原始 数组 中 的 对 应 字段 : 


>>> c = a[1] 

>>> c["name" ] 二 uy ees 
>>> a[1]["name"] 

EN ETES 


结构 像 字典 一 样 可 以 通过 字符 串 下 标 获 取 其 对 应 的 字段 值 : 


>>> a[O]["name" ] 
'Zhang' 


我 们 不 但 可 以 获得 结构 元 素 的 某 个 字段 ， 还 可 以 直接 获得 结构 数组 的 字段 ， 它 返回 
的 是 原始 数组 的 视图 ， 因 此 可 以 通过 修改 b[0] 改 变 a[0]["age"] : 


>>> b=a[:]["age"] # 或 者 a["age"] 
>>> b 

array([32, 24]) 

>>> b[0] = 40 

>>> a[0][ age ] 

40 


通过 调用 a.tostring 或 者 a.tofile 方 法 ， 可 以 直接 输出 数组 a 的 二 进 制 形 式 : 


>>> a.tofile("test.bin") 


利用 下 面 的 C 语 言 程序 可 以 将 testbin 文 件 中 的 数据 读 取出 来 。 
内 存 对 齐 


C 语 言 的 结构 体 为 了 内 存 寻 址 方便 ， 会 自动 的 添加 一 些 填充 用 的 字 节 ， 这 叫做 内 存 
对 齐 。 例 如 如 果 把 下 面 的 name[32] 改 为 name[30] 的 话 ， 由 于 内 存 对 齐 问题 ， 在 
name 和 age 中 间 会 填补 两 个 字 节 ， 最 终 的 结构 体 大 小 不 会 改变 。 因 此 如 果 numpy 中 


的 所 配置 的 内 存 大 小 不 符合 C 语 言 的 对 齐 规范 的 话 ， 将 会 出 现 数据 错位 。 为 了 解决 
这 个 问题 ， 在 创建 dtype 对 象 时 ， 可 以 传递 参数 align=True， 这 样 numpy 的 结构 数组 
的 内 存 对 齐 和 C 语 言 的 结构 体 就 一 致 了 。 


#include <stdio.h> 


struct person 


{ 
char name[32]; 
int age; 
float weight; 
}; 


struct person p[2]; 
void main () 


FILE *fp; 
Ente os 
fp=fopen("test.bin", "rb"); 
fread(p, sizeof(struct person), 2, fp); 
fclose(fp); 
for(i=0;1<2; i++) 
printf("%s %d %f\n", p[i].name, p[i].age, p[i].weight); 
getchar(); 


结构 类 型 中 可 以 包括 其 它 的 结构 类 型 ， 下 面 的 语句 创建 一 个 有 一 个 字段 f1 的 结构 ， 
f1 的 值 是 另外 一 个 结构 ， 它 有 字段 2P， 其 类 型 为 16bit 整 数 。 


>>> np.dtype([('fi', [('f2', np.int16)])]) 
dtype([('f1', [('f2', '<i2')])]) 


当 某 个 字段 类 型 为 数组 时 ， 用 组 元 的 第 三 个 参数 表示 ， 下 面 描述 的 f1 字 段 是 一 个 
shape 为 (2,3) 的 双 精 度 浮 点 数组 : 


>>> np.dtype([('fo', '14'), ('f1', 'f8', (2, 3))]) 
dtype([('fo', ‘<i4'), ('f1', '<f8', (2, 3))]) 


用 下 面 的 字典 参数 也 可 以 定义 结构 类 型 ， 字 典 的 关键 字 为 结构 中 字段 名 ， 值 为 字段 
的 类 型 描述 ， 但 是 由 于 字典 的 关键 字 是 没有 顺序 的 ， 因 此 字段 的 顺序 需要 在 类 型 描 
述 中 给 出 ， 类 型 描述 是 一 个 组 元 ， 它 的 第 二 个 值 给 出 字段 的 字 节 为 单位 的 偏 移 量 ， 
例如 age 字段 的 偏 移 量 为 25 个 字 节 : 


>>> np.dtype({'surname':('S25',0), 'age':(np.uint8, 25)}) 
dtype([('surname’, '|S25'), ('age', '|u1')]) 


内 存 结 构 


下 面 让 我 们 来 看 看 ndarray 数 组 对 象 是 如 何在 内 存 中 储存 的 。 如 下 图 所 示 ， 关 于 数组 
的 描述 信息 保存 在 一 个 数据 结构 中 ， 这 个 结构 引用 两 个 对 象 : 一 块 用 于 保存 数据 的 
存储 区 域 和 一 个 用 于 描述 元 素 类 型 的 dtype 对 和 象 。 





ndarray 数 据 结 构 
float32 描 述 数 组 的 元 素 类 型 
dtype Q— float32 描述 数组 的 元 素 类 
dim count 2 | 
dimensions 3 3 


strides 12 4 | 


data + e—_ 0113121314185 








12bytes 


ndarray 数 组 对 象 在 内 存 中 的 储存 方式 


数据 存储 区 域 保存 着 数组 中 所 有 元 素 的 二 进 制 数据 ，dtype 对 象 则 知道 如 何 将 元 素 
的 二 进 制 数 据 转 换 为 可 用 的 值 。 数 组 的 维 数 、 大 小 等 信息 都 保存 在 ndarray 数 组 对 象 
的 数据 结构 中 。 图 中 显示 的 是 如 下 数组 的 内 存 结构 : 


>>> a = np.array([[0,1,2],[3,4,5],[6,7,8]], dtype=np.float32) 


strides 中 保存 的 是 当 每 个 轴 的 下 标 增 加 1 时 ， 数 据 存储 区 中 的 指针 所 增加 的 字 节 
数 。 例 如 图 中 的 strides 为 12,4， 即 第 0 轴 的 下 标 增 加 1 时 ， 数 据 的 地 址 增加 12 个 字 
节 : 即 a[1,0] 的 地 址 比 a[0,0] 的 地 址 要 高 12 个 字 节 ， 正 好 是 3 个 单 精度 浮 点 数 的 总 字 
a ; 第 1 轴 下 标 增 加 1 时 ， 数 据 的 地 址 增加 4 个 字 节 ， 正 好 是 单 精 度 浮 点 数 的 字 节 
如 果 strides 中 的 数值 正好 和 对 应 轴 所 占据 的 字 节 数 相同 的 话 ， 那 么 数据 在 内 存 中 是 
连续 存储 的 。 然 而 数据 并 不 一 定 都 是 连续 储存 的 ， 前 面 介 绍 过 通过 下 标 范 围 得 到 新 
的 数组 是 原始 数组 的 视图 ， 即 它 和 原始 视图 共享 数据 存储 区 域 : 


>>> b = a[::2,::2] 
>>> b 
array([[ 0., 2.], 
[ 6., 8.]], dtype=float32) 
>>> b.strides 
(24, 8) 


由 于 数组 b 和 数组 a 共 享 数据 存储 区 ， 而 b 中 的 第 0 轴 和 第 1 轴 都 是 数组 a 中 隔 一 个 元 素 
取 一 个 ， 因 此 数组 b 的 strides 变 成 了 24,8， 正 好 都 是 数组 a 的 两 倍 。 对 照 前 面 的 图 很 
容易 看 出 数据 0 和 2 的 地 址 相差 8 个 字 节 ， 而 0 和 6 的 地 址 相差 24 个 字 节 。 


元 素 在 数据 存储 区 中 的 排列 格式 有 两 种 ; C 语 言 格 式 和 Fortan 语 言 格式 。 在 C 语 言 
中 ， 多 维 数组 的 第 0 轴 是 最 上 位 的 ， 即 第 0 轴 的 下 标 增 加 1 时 ， 元 素 的 地 址 增加 的 字 
节 数 最 多 ; 而 Fortan 话 言 的 多 维 数组 的 第 0 轴 是 最 下 位 的 ， 即 第 0 轴 的 下 标 增 加 1 
时 ， 地 址 只 增加 一 个 元 素 的 字 节 数 。 在 NumPy 中 ， 元 素 在 内 存 中 的 排列 缺 省 是 以 C 
ee, 如 果 你 希望 改 为 Fortan 格 式 的 话 ， 只 需要 给 数组 传递 order="F" 参 


>>> c = np.array([[0,1,2],[3,4,5],[6,7,8]], dtype=np.float32, ordei 
>>> c.strides 
(4, 12) 





ufunciz & 


ufunc 是 universal function 的 缩写 ， 它 是 一 种 能 对 数组 的 每 个 元 素 进 行 操作 的 函数 。 
NumPy 内 和 置 的 许多 ufunc 画 数 都 是 在 C 语 言 级 别 实现 的 ， 因 此 它们 的 计算 速度 非常 
快 。 让 我 们 来 看 一 个 例子 


>>> x = np.linspace(0, 2*np.pi, 10) 

# xt Pax RAEDT RTEA, ETA HA Mae 

>>> y = np.sin(x) 

>>> y 

array([ 0©.00000000e+00, 6.42787610e-01, 9.84807753e-01, 
8.66025404e-01, 3.42020143e-01, -3.42020143e-01, 
-8.66025404e-01, -9.84807753e-01, -6.42787610e-01, 
-2.44921271e-16]) 


A FAllinspace = £—“*SMOSI2*PIRVS ERANDA, ABR A Asina, A 
Fnp.sine—‘ufuncHi Xk, Albexstx PASTS KEM, Ae Rikgl, 
并 且 赋 值 给 y。 计 算 之 后 x 中 的 值 并 没有 改变 ， 而 是 新 创建 了 一 个 数组 保存 结果 。 如 
果 我 们 希望 将 sin 画 数 所 计算 的 结果 直接 履 盖 到 数组 Xx 上 去 的 话 ， 可 以 将 要 被 覆盖 的 
数组 作为 第 二 个 参数 传递 给 ufunc 男 数 。 例 如 : : 


>>> t = np.sin(x,x) 

>>> x 

array([ 0.00000000e+00, 6.42787610e-01, 9.84807753e-01, 
8.66025404e-01, 3.42020143e-01, -3.42020143e-01, 
-8.66025404e-01, -9.84807753e-01, -6.42787610e-01, 
-2.44921271e-16]) 

>>> id(t) == id(x) 

True 


sin 函 数 的 第 二 个 参数 也 是 x， 那 么 它 所 做 的 事情 就 是 对 x 中 的 每 给 值 求 正弦 值 ， 并 且 
把 结果 保存 到 x 中 的 对 应 的 位 置 中 。 此 时 阔 数 的 返回 值 仍 然 是 整个 计算 的 结果 ， 只 
不 过 它 就 是 x， 因 此 两 个 变量 的 id 是 相同 的 (变量 t 和 变量 x 指向 同一 块 内 存 区 域 )。 


我 用 下 面 这 个 小 程序 ， 比 较 了 一 下 numpy.math 和 Python 标准 库 的 math.sin 的 计算 速 


EB :: 


import time 
import math 
import numpy as np 


xX = [i * 0.001 for i in xrange(1000000) | 
start = time.clock() 
for i, t in enumerate(x): 
x[i] = math.sin(t) 
print "math.sin:", time.clock() - start 


xX = [i * 0.001 for i in xrange(1000000) | 
x = np.array(x) 

start = time.clock() 

np.sin(x,xX) 

print "numpy.sin:", time.clock() - start 


# 输出 
# math.sin: 1.15426932753 
# numpy.Sin: 0.0882399858083 


在 我 的 电脑 上 计算 100 万 次 正弦 值 ，numpy.sin 比 math.sin 快 10 倍 多 。 这 得 利于 
numpy.sin 在 C 语 言 级 别 的 循环 计算 。numpy.sin 同 祥 也 支持 对 单个 数值 求 正 弦 ， 例 
如 : numpy.sin(0.5)。 不 过 值得 注意 的 是 ， 对 单个 数 的 计算 math.sin 则 比 numpy.sin 
快 得 多 了 ， 让 我 们 看 下 面 这 个 测试 程序 : 


x = [i * 0.001 for i in xrange(1000000) | 
start = time.clock() 
for i, t in enumerate(x): 
x[i] = np.sin(t) 
print "numpy.sin loop:", time.clock() - start 


# 输出 
# numpy.sin loop: 5.72166965355 


请 注意 numpy.sin 的 计算 速度 只 有 math.sin 的 115。 这 是 因为 numpy.sin 为 了 同时 支持 
数组 和 单个 值 的 计算 ， 其 C 语 言 的 内 部 实现 要 比 math.sin 复 条 很 多 ， 如 果 我 们 同样 
在 Python 级 别 进行 循环 的 话 ， 就 会 看 出 其 中 的 差别 了 。 此 外 ，numpy.sin 返 回 的 数 
的 类 型 和 math.sin 返 回 的 类 型 有 所 不 同 ，math.sin 返 回 的 是 Python 的 标准 float 类 
型 ， 而 numpy.sin 则 返回 一 个 numpy.float64 类 型 : 


>>> type(math.sin(0.5)) 
<type 'float'> 

>>> type(np.sin(0.5)) 
<type 'numpy.float64'> 


通过 上 面 的 例子 我 们 了 解 了 如 何 最 有 效率 地 使 用 math 库 和 numpy 库 中 的 数学 函数 。 
因为 它们 各 有 长 短 ， 因 此 在 导入 时 不 建议 使 用 * 号 全 部 载 入 ， 而 是 应 该 使 用 import 
numpy as np 的 方式 载 和 人 ， 这 样 我 们 可 以 根据 需要 选择 合适 的 画 数 调用 。 


NumPy 中 有 众多 的 ufunc 函 数 为 我 们 提供 各 式 各 样 的 计算 。 除 了 sin 这 种 单 输入 画 数 
之 外 ， 还 有 许多 多 个 输入 的 函数 ，add 函 数 就 是 一 个 最 常用 的 例子 。 先 来 看 一 个 例 
子 : 


>>> a = np.arange(0, 4) 
>>> a 

array([0, 1, 2, 3]) 
>>> b = np.arange(1,5) 
>>> b 

array([1, 2, 3, 4]) 
>>> np.add(a,b) 
array([1, 3, 5, 7]) 
>>> np.add(a,b,a) 
array([1, 3, 5, 7]) 
>>> a 

array([1, 3, 5, 7]) 


add 画 数 返回 一 个 新 的 数组 ， 此 数组 的 每 个 元 素 都 为 两 个 参数 数组 的 对 应 元 素 之 
和 。 它 接受 第 3 个 参数 指定 计算 结果 所 要 写 入 的 数组 ， 如 果 指 定 的 话 ，add 辑 数 就 不 
再 产生 新 的 数组 。 


由 于 Python 的 操作 符 重 载 功 能 ， 计 算 两 个 数组 相 加 可 以 简单 地 写 为 atb， 而 
np.add(a,b,a) 则 可 以 用 a+=b 来 表示 。 下 面 是 数组 的 运算 符 和 其 对 应 的 ufunc 本 数 的 
一 个 列表 ， 注 意 除 号 "/" 的 意义 根据 是 否 激活 future.division 有 所 不 同 。 


y=x1+x2:  add(x1, x2 [, y]) 

y = X1 - x2: subtract(x1, x2 [, y]) 

y =x1 * x2: multiply (x1, x2 [, y]) 

divide (x1, x2 [, y]), 如 果 两 个 数组 的 元 素 为 整数 ， 那 么 用 整数 除 


y=x1/x2: true divide (x1, x2 [, y]), 总 是 返回 精确 的 商 
y=x1//x2: ”floor divide (x1, x2 [, y]), 总 是 对 返回 值 取 整 


y = x1 / x2: 


y =-x: negative(x [,y]) 
y =x1"*x2: power(x1, x2 [, y]) 


ae XL remainder(x1, x2 [, y]), mod(x1, x2, [, y]) 
数组 对 象 支持 这 些 操 作 符 ， 极 大 地 简化 了 算式 的 编写 ， 不 过 要 注意 如 果 你 的 算式 很 
复杂 ， 并 且 要 运算 的 数组 很 大 的 话 ， 会 因为 产生 大 量 的 中 间 结 果 而 降低 程序 的 运算 
效率 。 例 如 : 假设 a b c 三 个 数组 采用 算式 x=a*b+c 计 算 ， 那 么 它 相 当 于 : 


wasa” lo 
~ Sit wr Cc 
del t 


也 就 是 说 需要 产生 一 个 数组 t 保 存 乘 法 的 计算 结果 ， 然 后 再 产生 最 后 的 结果 数组 X。 
我 们 可 以 通过 手工 将 一 个 算式 分 解 为 Xx = a*b; x += c， 以 减少 一 次 内 存 分 配 。 


通过 组 合 标准 的 ufunc 画 数 的 调用 ， 可 以 实现 各 种 算式 的 数组 计算 。 不 过 有 些 时 候 
这 种 算式 不 易 编写 ， 而 针对 每 个 元 素 的 计算 函数 却 很 容易 用 Python 实 现 ， 这 时 可 以 
用 frompyfunc 函 数 将 一 个 计算 单个 元 素 的 画 数 转换 成 ufunc 函 数 。 这 样 就 可 以 方便 地 
用 所 产生 的 ufunc 函 数 对 数组 进行 计算 了 。 让 我 们 来 看 一 个 例子 。 


我 们 想 用 一 个 分 段 男 数 接 述 三 角 波 ， 三 角 波 的 样子 如 下 图 所 示 : 














0.0 0.5 1.0 15 2.0 
三 角 波 可 以 用 分 段 范 数 进行 计算 
我 们 很 容易 根据 上 图 所 示 写 出 如 下 的 计算 三 角 波 某 点 y 坐 标的 了 范 数 : 


def triangle_wave(x, c, c0, hc): 
x = x - int(x)# 三 角 波 的 周期 为 1， 因 此 只 取 x 坐 标的 小 数 部 分 进行 计算 
if x >=c: r = 0.0 
elif x < c0: r =x / c0 * he 
else: r = (c-x) / (c-cO) * he 
return r 


显然 triangle_wave 辑 数 只 能 计算 单个 数值 ， 不 能 对 数组 直接 进行 处 理 。 我 们 可 以 用 
下 面 的 方法 先 使 用 列表 包容 (List comprehension), it@W—Nist, ie array 
数 将 列表 转换 为 数组 : 


np.linspace(0, 2, 1000) 
np.array([triangle_wave(t, 0.6, 0.4, 1.0) for t in x]) 


这 种 做 法 每 次 都 需要 使 用 列表 包容 语法 调用 范 数 ， 对 于 多 维 数组 是 很 麻烦 的 。 让 我 
们 来 看 看 如 何 用 frompyfunc 函 数 来 解决 这 个 问题 : 


triangle_ufunc = np.frompyfunc( lambda x: triangle wave(x, 0.6, 0.¢ 
y2 = triangle_ufunc(x) 


E o ee 


frompyfunc 的 调用 格式 为 ffompyfunc(func, nin, nout)， 其 中 func 是 计算 单个 元 素 的 
函数 ，nin 是 此 函数 的 输入 参数 的 个 数 ，nout 是 此 函数 的 返回 值 的 个 数 。 虽 然 
triangle_wave 辑 数 有 4 个 参数 ， 但 是 由 于 后 三 个 c, c0, hc 在 整个 计算 中 值 都 是 固定 
的 ， 因 此 所 产生 的 ufunc 函 数 其 实 只 有 一 个 参数 。 为 了 满足 这 个 条 件 ， 我 们 用 一 个 
lambda 画 数 对 triangle _ wave 的 参数 进行 一 次 包装 。 这 样 传 人 frompyfunc 的 函数 就 只 
有 一 个 参数 了 。 这 样子 做 ， 效 率 并 不 是 太 高 ， 另 外 还 有 一 种 方法 : 





def triangle_func(c, cO, hc): 
def trifunc(x): 


x = x - int(x) # 三 角 波 的 周期 为 1， 因 此 只 取 x 坐 标的 小 数 部 分 进行 计算 
if x >=c: r = 0.0 

elif x < cO: r = x / cO * he 

else: r = (c-x) / (c-cO) * hc 

return r 


# AtrifuncWAe|2—TufunchRm, PARR twa TiS, Ken bw 
# 计算 得 到 的 是 一 个 Object 数组 ， 需 要 进行 类 型 转换 
return np.frompyfunc(trifunc, 1, 1) 


y2 = triangle_func(0.6, 0.4, 1.0)(x) 
4 =: -LA 


我 们 通过 函数 triangle_func 包 装 三 角 波 的 三 个 参数 ， 在 其 内 部 定义 一 个 计算 三 角 波 
的 函数 trifunc，trifunc 函 数 在 调用 时 会 采用 triangle_func 的 参数 进行 计算 。 最 后 
triangle_func 返 回 用 frompyfunc 转 换 结果 。 


值得 注意 的 是 用 frompyfunc 得 到 的 函数 计算 出 的 数组 元 素 的 类 型 为 object， 因 为 
frompyfunc 函 数 无 法 保证 Python 函 数 返 回 的 数据 类 型 都 完全 一 致 。 因 此 还 需要 再 次 
y2.astype(np.float64) 将 其 转换 为 双 精 度 浮 点 数组 。 


广播 


当 我 们 使 用 ufunc 画 数 对 两 个 数组 进行 计算 时 ，ufunc 画 数 会 对 这 两 个 数组 的 对 应 元 
素 进 行 计 算 ， 因 此 它 要 求 这 两 个 数组 有 相同 的 大 小 (shape 相 同 )。 如 果 两 个 数组 的 
shape 不 同 的 话 ， 会 进行 如 下 的 广播 (broadcasting) 人 处 理 : 


1. 让 所 有 输入 数组 都 向 其 中 shape 最 长 的 数组 看 齐 ，shape 中 不 足 的 部 分 都 通过 
在 前 面 加 1 补 齐 

2. 输出 数组 的 shape 是 输入 数组 shape 的 名 个 轴 上 的 最 大 信 

3. 如 果 输 入 数组 的 某 个 轴 和 输出 数组 的 对 应 轴 的 长 度 相同 或 者 其 长 度 为 1 时 ， 这 
个 数组 能 够 用 来 计算 ， 否 则 出 错 

4. 当 输 入 数组 的 某 个 轴 的 长 度 为 1 时 ， 治 着 此 轴 运 算 时 都 用 此 轴 上 的 第 一 组 值 


上 述 4 条 规则 理解 起 来 可 能 比较 费劲 ， 让 我 们 来 看 一 个 实际 的 例子 
先 创建 一 个 二 维 数组 a， 其 shape 为 (6,1) : 


>>> a = np.arange(0, 60, 10).reshape(-1, 1) 
>>> a 

array([[ ©], [10], [20], [30], [40], [50]]) 
>>> a.shape 

(6, 1) 


再 创建 一 维 数 组 b， 其 shape 为 (5,) : 


>>> b = np.arange(0, 5) 
>>> b 

array([0, 1, 2, 3, 4]) 
>>> b.shape 


(5, ) 


计算 a 和 b 的 和 ， 得 到 一 个 加 法 表 ， 它 相当 于 计算 a,b 中 所 有 元 素 组 的 和 和， 得 到 一 个 
shape 为 (6,5) 的 数组 : 


>>> c=at+nb 
>>> C 
array([[ 0, 1, 2, 3, 4], 
[TOs Waly 12 13; 1, 
(20, 212223 2A] 
EO, ei SA SE SA 
[40, 41, 42, 43, 44], 
[505 51 527 53; 5411) 
>>> c.shape 
(6, 5) 


由 于 a 和 b 的 shape 长 度 ( 也 就 是 ndim 属 性 ) 不 同 ， 根 据 规则 1， 需 要 让 b 的 shape 向 a 对 
齐 ， 于 是 将 b 的 shape 前 面 加 1， 补 齐 为 (1,5)。 相 当 于 做 了 如 下 计算 : 


>>> b.shape=1,5 
>>> b 
array([[0, 1, 2, 3, 4]]) 


这 样 加 法 运算 的 两 个 输入 数组 的 shape 分 别 为 (6,1) 和 (1,5)， 根 据 规则 2， 输 出 数组 的 
各 个 轴 的 长 度 为 输入 数组 各 个 轴 上 的 长 度 的 最 大 值 ， 可 知 输出 数组 的 shape 为 
(6,5)。 


由 于 b 的 第 0 轴 上 的 长 度 为 1， 而 a 的 第 0 轴 上 的 长 度 为 6， 因 此 为 了 让 它们 在 第 0 轴 上 
能 够 相 加 ， 需 要 将 b 在 第 0 轴 上 的 长 度 扩 展 为 6， 这 相当 于 : 


>>> b = b.repeat(6,axis=0) 


>>> b 

array([[0, us 2, 3, 4], 
[0, 1, 2, 3, 4], 

[0, 1, 2, 3, 4], 

[0, 1, 2, 3, 4], 

[0, 1, 2, 3, 4], 

[0, 1, 2, 3, 4]]) 


由 于 a 的 第 1 轴 的 长 度 为 1， 而 b 的 第 一 轴 长 度 为 5， 因 此 为 了 让 它们 在 第 1 轴 上 能 够 相 
加 ， 需 要 将 a 在 第 1 轴 上 的 长 度 扩 展 为 5， 这 相当 于 : 


>>> a = a.repeat(5, axis=1) 
>>> a 
array([[ 0, 0, 0, 0, 0], 
[10, 10, 10, 10, 10], 
[20, 20, 20, 20, 20], 
[30, 30, 30, 30, 30], 
[40, 40, 40, 40, 40], 
[50, 50, 50, 50, 50]]) 


经 过 上 述 处 理 之 后 ，a 和 b 就 可 以 按 对 应 元 素 进 行 相 加 运算 了 。 


当然 ，numpy 在 执行 a+b 运 算 时 ， 其 内 部 并 不 会 真正 将 长 度 为 1 的 轴 用 repeat 落 数 进 
行 扩 展 ， 如 果 这 样 做 的 话 就 太 浪费 空间 了 。 


由 于 这 种 广播 计算 很 常用 ， 因 此 numpy 提 供 了 一 个 快速 产生 如 上 面 a,b 数 组 的 方法 : 
ogrid 对 象 : 


>>> X,Y = np.ogrid[0:5,0:5] 
>>> X 
array([[0], 


array([[0, 1, 2, 3, 4]]) 


ogrid 是 一 个 很 有 趣 的 对 象 ， 它 像 一 个 多 维 数组 一 样 ， 用 切片 组 元 作为 下 标 进行 存 
取 ， 返 回 的 是 一 组 可 以 用 来 广播 计算 的 数组 。 其 切片 下 标 有 两 种 形式 : 


e。 开始 值 :结束 值 : 步 长 ， 和 np.arange( 开 始 值 , 结束 值 , 步 长 ) 类 似 


。 开始 值 :结束 值 :长 度 j， 当 第 三 个 参数 为 虚数 时 ， 它 表示 返回 的 数组 的 长 度 ， 和 
np.linspace( 开 始 值 , 结束 值 , 长 度 ) 类 似 : 


>>> X, y = np.ogrid[0:1:4j, 0:1:3j] 
>>> X 
array([[ O\. i 
[ ©.33333333], 
[ ©.66666667], 
[ 1\. ]]) 
>>> y 
array([[ Oo\，， 0.5, 1\. ]]) 


ogrid 为 什么 不 是 画 数 


根据 Python 的 语法 ， 只 有 在 中 括号 中 才能 使 用 用 冒号 隔 开 的 切片 语法 ， 如 果 ogrid 是 
函数 的 话 ， 那 么 这 些 切片 必须 使 用 slice 函 数 创建 ， 这 显然 会 增加 代码 的 长 度 。 


FA Python 做 科学 计算 


利用 ogrid 的 返回 值 ， 我 能 很 容易 计算 x, y 网 格 面 上 各 点 的 值 ， 或 者 x, y, z 网 格 体 上 各 
点 的 值 。 下 面 是 绘制 三 维 曲 面 exp(x*2 - y2) 的 程序 : 


import numpy as np 
from enthought.mayavi import mlab 


X, y = np.ogrid[-2:2:20j, -2:2:20j] 
z = xX * np.exp( - x**2 - y**2) 


pl = mlab.surf(x, y, z, warp_scale="auto" ) 
mlab.axes(xlabel='x', ylabel='y', zlabel='z') 
mlab.outline(pl) 


此 程序 使 用 mayavi 的 mlab 库 快速 绘制 如 下 图 所 示 的 3D 曲 面 ， 关 于 mlab 的 相关 内 容 
将 在 今后 的 章节 进行 介绍 。 





使 用 ogrid 创 建 的 三 维 曲 面 


ufunc 的 方法 


ufunc 辑 数 本 身 还 有 些 方法 ， 这 些 方法 只 对 两 个 输入 一 个 输出 的 ufunc 函 数 有 效 ， 其 
它 的 ufunc 对 象 调 用 这 些 方法 时 会 抛 出 ValueError 异 常 。 


reduce 方法 和 Python 的 reduce 函 数 类 似 ， 它 治 着 axis 轴 对 array 进 行 操作 ， 相 当 于 
将 <op> 运 算 符 插入 到 治 axis 轴 的 所 有 子 数组 或 者 元 素 当 中 。 


>>> np.add.reduce([1,2,3]) #1+2+ 3 

6 

>>> np.add.reduce([[1,2,3],[4,5,6]], axis=1) # 1,4 + 2,5 + 3,6 
array([ 6, 15]) 
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accumulate 方法 和 reduce 方 法 类 似 ， 只 是 它 返 回 的 数组 和 输入 的 数组 的 shape 相 
同 ， 保 存 所 有 的 中 间 计 算 结 果 : 


>>> np.add.accumulate([1,2,3]) 
array([1, 3, 6]) 
>>> np.add.accumulate([[1,2,3],[4,5,6]], axis=1) 
array([[ 1, 3, 6], 
[ 4, 9, 15]]) 


reduceat 方法 计算 多 组 reduce 的 结果 ， 通 过 indices 参 数 指定 一 系列 reduce 的 起 始 
和 终了 位 置 。reduceat 的 计算 有 些 特 别 ， 让 我 们 通过 一 个 例子 来 解释 一 下 : 


>>> a = np.array([1,2,3,4]) 

>>> result = np.add.reduceat(a, indices=[0,1,0,2,0,3,0]) 
>>> result 

anray irm Sse oy Ore 4 LOY) 


对 于 indices 中 的 每 个 元 素 都 会 调用 reduce 函 数 计算 出 一 个 值 来 ， 因 此 最 终 计 算 结 果 
的 长 度 和 indices 的 长 度 相 同 。 结 果 result 数 组 中 除 最 后 一 个 元 素 之 外 ， 都 按照 如 下 
计算 得 出 : 

np.reduce(a[indices[-1]:]) 


因此 上 面 例子 中 ， 结 果 的 每 个 元 素 如 下 计算 而 得 : 


>>> a.shape += (1, )*b.ndim 
>>> <op>(a,b) 
>>> a = a.squeeze() 


Hrhsqueezef Wace al Raat KE 4 1i4. MRMRARAH ASSAY 
的 话 ， 让 我 们 来 看 一 个 例子 : 


>>> np.multiply.outer([1,2,3,4,5],[2,3,4]) 
array([[ 2, 3, 4], 


可 以 看 出 通过 outer 方 法 计算 的 结果 是 如 下 的 乘法 表 : 


# 2n op A 
#1 
#2 
#3 
#4 
#5 
如 果 将 这 两 个 数组 按照 等 同 程序 一 步 一 步 的 计算 的 话 ， 就 会 发 现 乘法 表 最 终 是 通过 
广播 的 方式 计算 出 来 的 。 


算 阵 运算 


NumPy 和 Matlab 不 一 样 ， 对 于 多 维 数组 的 运算 ， 缺 省 情况 下 并 不 使 用 矩阵 运算 ， 如 
果 你 希 鞋 对 数组 进行 矩阵 运算 的 话 ， 可 以 调用 相应 的 函数 。 


matrix 对 象 


numpy 库 提供 了 matrix 类 ， 使 用 matrix 类 创建 的 是 和 矩阵 对 象 ， 它 们 的 加 减 乘 除 运算 
缺 省 采用 矩阵 方式 计算 ， 因 此 用 法 和 matlab 十 分 类 似 。 但 是 由 于 NumPy 中 同时 存在 
ndarray 和 matrix 对 象 ， 因 此 用 户 很 容易 将 两 者 弄 混 。 这 有 违 Python 的 “ 显 式 优 于 隐 
ee 因此 并 不 推荐 在 较 复杂 的 程序 中 使 用 matrix。 下 面 是 使 用 matrix 的 一 个 
列子 : 


>>> a = np.matrix([[1,2,3],[5,5,6],[7,9,9]]) 

>>> aac all 

matrix([[ 1.00000000e+00,  1.66533454e-16, -8.32667268e-17], 
[ -2.77555756e-16,  1.00000000e+00, -2.77555756e-17], 
[ 1.66533454e-16,  5.55111512e-17, 1.00000000e+00]]) 


Al ae matrise SAAB xt R, AERAN Hie BAR Se eR, Pek 
Hit Bere atl Ae eee, Reh BLES. 


ERR A LE Adot MwA Tite, FCA, CHa See, WF 
一 维 数 组 ， 它 计算 的 是 其 点 积 。 当 需要 将 一 维 数组 当 作 列 矢 量 或 者 行 矢量 进行 矩阵 
运算 时 ， 推 荐 先 使 用 reshape 画 数 将 一 维 数组 转换 为 二 维 数组 : 


>>> a = array([1, 2, 3]) 
>>> a.reshape((-1,1)) 
array({[1], 

[2], 
[3]]) 
>>> a.reshape((1, -1)) 
array([[1, 2, 3]]) 


RT dotit Bae ZA, NumPyit Hlk T inner#louter] 4 tit BRAN WR, itt 
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e dot: 对 于 两 个 一 维 的 数组 ， 计 算 的 是 这 两 个 数组 对 应 下 标 元 素 的 乘积 和 (数学 
上 称 之 为 内 积 ) ; 对 于 二 维 数组 ， 计 算 的 是 两 个 数组 的 矩阵 乘积 ; 对 于 多 维 数 
组 ， 它 的 通用 计算 公式 如 下 ， 即 结果 数组 中 的 每 个 元 素 都 是 : 数组 a 的 最 后 一 
维 上 的 所 有 元 素 与 数组 b 的 倒数 第 二 位 上 的 所 有 元 素 的 乘积 和 : 


dot(a, b)[i,j,k,m] = sum(a[i,j,:] * b[k,:,m]) 


下 面 以 两 个 3 为 数组 的 乘积 演示 一 下 dot 乘 积 的 计算 结果 : 
首先 创建 两 个 3 维 数组 ， 这 两 个 数组 的 最 后 两 维 满 足 和 矩阵 乘积 的 条 件 : 


&gt;&gt;&gt; a = np.arange(12).reshape(2, 3,2) 
&gt;&gt;&gt; b = np.arange(12, 24).reshape(2,2,3) 
&gt;&gt;&gt; c = np.dot(a,b) 


dot 乘 积 的 结果 c 可 以 看 作 是 数组 a,b 的 多 个 子 矩 阵 的 乘积 : 


&égt;&gt;&gt; np.alltrue( c[0,:,0,:] == np.dot(a[0],b[0]) ) 
O apes np.alltrue( c[1,:,6,:] == np-dot(a[i],b[o]) ) 
ee arent np.alltrue( c[0,:,1,:] == np.dot(a[0],b[1]) ) 
o T np-alltrue( ¢[1,:,4,:] == np.dot(alil,b[21])) ) 
True 


EJE 


e inner : 和 dot 乘 积 一 样 ， 对 于 两 个 一 维 数组 ， 计 算 的 是 这 两 个 数组 对 应 下 标 元 
素 的 乘积 和 ; 对 于 多 维 数组 ， 它 计算 的 结果 数组 中 的 每 个 元 素 都 是 : 数组 a 和 b 
的 最 后 一 维 的 内 积 ， 因 此 数组 a 和 b 的 最 后 一 维 的 长 度 必 须 相 同 : 


inner(a, b)[1,j,k,m] = sum(a[i,j,:]*b[k,m,:]) 


下 面 是 inner 乘 积 的 演示 : 


&gt;&gt;&gt; a = np.arange(12).reshape(2, 3,2) 
&gt;&gt;&gt; b = np.arange(12,24).reshape(2, 3,2) 
&gt;&gt;&gt; c = np.inner(a,b) 

&gt;&gt;&gt; c.shape 

(2, 3, 2, 3) 

&gt;&gt;&gt; c[0,0,0,0] == np.inner(a[0,0],b[0,0] ) 
True 

&gt;&gt;&gt; c[0,1,1,0] == np.inner(a[0,1],b[1,0] ) 
True 

&gt;&gt;&gt; c[1,2,1,2] == np.inner(a[1,2],b[1,2]) 
True 


e outer: 只 按照 一 维 数组 进行 计算 ， 如 果 传 人 参数 是 多 维 数组 ， 则 先 将 此 数组 展 
平 为 一 维 数组 之 后 再 进行 运算 。outer 乘 积 计算 的 列 向 量 和 行 向 量 的 和 矩阵 乘积 : 


cot edt got np. outen 2,44). A S e Tr 
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和 矩阵 中 更 高 级 的 一 些 运算 可 以 在 NumPy 的 线性 代数 子 库 linalg 中 找到 。 例 如 inv 画 数 
计算 道 矩 阵 ，solve 函 数 可 以 求解 多 元 一 次 方程 组 。 下 面 是 solve 函 数 的 一 个 例子 : 


>>> a = np.random.rand(10, 10) 

>>> b = np.random.rand(10) 

>>> X = np.linalg.solve(a,b) 

>>> np.sum(np.abs(np.dot(a,x) - b)) 
3.1433189384699745e-15 


solve HA AeBSMatlb. aZ—ThN* NN ža, Mbez—-hKEANN—-4R 
28, solve ARE — AKE ANE — eža, apih E RRE Fb, 
组 x 就 是 多 元 一 次 方程 组 的 解 。 


有 关 线 性 代数 方面 的 内 容 将 在 今后 的 章节 中 详细 介绍 。 


文件 存 取 


NumPy 提 供 了 多 种 文件 操作 画 数 方便 我 们 存 取 数 组 内 容 。 文 件 存 取 的 格式 分 为 两 
类 : 二 进 制 和 文本 。 而 二 进 制 格式 的 文件 又 分 为 NumPy 专 用 的 格式 化 二 进 制 类 型 和 


使 用 数组 的 方法 函数 tofile 可 以 方便 地 将 数组 中 数据 以 二 进 制 的 格式 写 进 文件 。tofile 
输出 的 数据 没有 格式 ， 因 此 用 numpy.fromfile 读 回来 的 时 候 需 要 自己 格式 化 数据 : 


>>> a = np.arange(0,12) 
>>> a.shape = 3,4 
>>> a 
array([[ 9, 1, 2, 3], 
[ 4, 5, 6, 7], 
[ 8, 9, 10, 11]]) 
>>> a.tofile("a.bin") 
>>> b = np.fromfile("a.bin", dtype=np.float) # 按照 float 类 型 读 入 数据 
>>> b # 读 入 的 数据 是 错误 的 
array([ 2.12199579e-314, 6.36598737e-314, 1.06099790e-313, 
1.48539705e-313, 1; 90979621e-313, 2.33419537e-313] ) 
>>> a.dtype # 查看 a 的 dtype 
dtype(‘'int32') 
>>> b = np.fromfile("a.bin", dtype=np.int32) # 按照 int32 类 型 读 入 数据 
>>> b # 数据 是 一 维 的 
array([ 0 i, 2, 3, 4, 5, 68, 7, 87° 9, 10, 11))) 
>>> b.shape = 3, 4 # 按照 有 a 的 shape 修 改 b 的 shape 
>>> b # 这 次 终于 正确 了 
array([[ 9, 1, 2, 3], 
[ 4, 5, 6, 7], 
[ 8, 9, 10, 11]]) 


JE EE ST 


从 上 面 的 例子 可 以 看 出 ， 需 要 在 读 入 的 时 候 设 置 正确 的 dtype 和 shape 才 能 保证 数据 
一 致 。 并 且 tofile 函 数 不 管 数组 的 排列 顺序 是 C 语 言 格式 的 还 是 Fortran 语 言 格式 的 ， 
统一 使 用 C 语 言 格式 输出 。 


此 外 如 果 fromfile 和 tofile 函 数 调用 时 指定 了 sep 关 键 字 参数 的 话 ， 数 组 闻 以 文本 格式 
输入 输出 。 


numpyload 和 numpy.save 画 j 数 以 NumPy 专 用 的 二 进 制 类 型 保存 数据 ， 这 两 个 函数 
会 自动 处 理 元 素 类 型 和 shape 等 信息 ， 使 用 ALL ame 但 是 
numpy.save 输 出 的 文件 很 难 和 其 它 语言 编写 的 程序 读 


>>> np.save("a.npy", a) 
>>> c = np.load( "a.npy" ) 
>>> C 

array([[ ©, 1, 2, 3], 
[ea Se Gr le 

[ 8, 9, 10, 11]]) 


如 果 你 想 将 多 个 数组 保存 到 一 个 文件 中 的 话 ， 可 以 使 用 numpy.savez 画 JŽ savez 
函数 的 第 一 个 参数 是 文件 名 ， 其 后 的 参数 都 是 需要 保存 的 数组 ， 也 可 以 使 用 关键 字 
参数 为 数组 起 一 个 名 字 ， 非 关键 字 参数 传递 的 数组 会 自动 起 名 为 arr_0, arr_1, …。 


savez 辑 数 输 出 的 是 一 个 不 缩 文件 (扩展 名 为 npz)， 其 中 每 个 文件 都 是 一 个 save 力 ar 
REM npyMt, MAB eras. badi A Wiz slnpzeet, ERE 
类 似 于 字典 的 对 象 ， 可 以 通过 数组 名 作为 关键 字 获 取 数 组 的 内 容 : 


>>> a = np.array([[1,2,3],[4,5,6]]) 
>>> b = np.arange(0, 1.0, 0.1) 
>>> C = np.sin(b) 


>>> np.savez("result.npz", a, b, Sin_array = c) 
>>> r = np.load("result.npz") 
>>> r["arr_0"] # 数组 a 
array([[1, 2, 3], 
[4, 5, 6]]) 
>>> r["arr_i"] # 数组 b 
anrray( ON , 0.1, 0.2, 0.3, 0.4, 0.5, 0.6, 0.7, 0.8, 0.9 
>>> r["sin_array"] # 数组 c 
array([ O\. , ©.09983342, 0.19866933, 0.29552021, 0.389: 
0.47942554, 0.56464247, 0.64421769, 0.71735609, 0.78332691]) 


Ei = 


如 果 你 用 解压 软件 打开 result.npz 文 件 的 话 ， 会 发 现 其 中 有 三 个 文件 : arr_0.npy， 
arr_1.npy, sin_array.npy， 其 中 分 别 保存 着 数组 a, b, c 的 内 容 。 


使 用 numpy.savetxt 和 numpy.loadtxt 可 以 读 宇 1 维和 2 维 的 数组 : 





>>> a = np.arange(0,12,0.5).reshape(4, -1) 

>>> np.savetxt("a.txt", a) # 缺 省 按照 '"%.18e' 格 式 保存 数据 ， 以 空格 分 隔 
>>> np.loadtxt("a.txt") 

array([[ O\. , ORS, aN: 15, 25 225), 
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>>> np.savetxt("a.txt", a, fmt="%d", delimiter=",") # 改 为 保存 为 整数 ， 
>>> np.loadtxt("a.txt" ,delimiter=", ") # 读 入 的 时 候 也 需要 指定 逗号 分 隔 
array([[ 0., ©., 1. T E | 

e oe , de, 2, By BT 
[WE 

ioe, fh, le. Sie. 1 





文件 名 和 文件 对 象 


本 节 介 绍 所 举 的 例子 都 是 传递 的 文件 名 ， 也 可 以 传递 已 经 打开 的 文件 对 象 ， 例 如 对 
于 load 和 save 国 数 来 说 ， 如 果 使 用 文件 对 象 的 话 ， 可 以 将 多 个 数组 储存 到 一 个 npy 
文件 中 : 


>>> 
>>> 
>>> 
>>> 
>>> 
>>> 
>>> 
>>> 
>>> 


a = np.arange(8) 

b = np.add.accumulate(a) 
c=a+b 

f = file("result.npy", "wb") 


np.save(f, a) # 顺序 将 a, b,c 保存 进 文 件 对 象 f 
np.save(f, b) 

np.save(f, c) 

f.close() 

f = file("result.npy", "rb") 


>>> np.load(f) # 顺序 从 文件 对 象 f 中 读 取 内 容 
aaizayi (hO sultan 2h ets eS be 7) 

>>> np.load(f) 

array([ ©, 1, 3, 6, 10, 15, 21, 28]) 
>>> np.load(f) 


array([ ©, 2, 5, 9, 14, 20, 27, 35]) 


SciPy- 数 值 计算 库 


SciPy 画 数 库 在 NumPy 库 的 基础 上 增加 了 众多 的 数学 、 科 学 以 及 工程 计算 中 常用 的 
库 图 数 。 例 如 线性 代数 、 常 微分 方程 数值 求解 、 信 号 处 理 、 图 像 处 理 、 稀 球 矩阵 等 
等 。 由 于 其 涉及 的 领域 众多 、 本 书 没 有 能 力 对 其 一 一 的 进行 介绍 。 作 为 入 门 介 绍 ， 
让 我 们 看 看 如 何 用 SciPy 进 行 插值 处 理 、 信 号 滤波 以 及 用 C 语 言 加 速 计 算 。 


最 小 二 乘 拟 合 


假设 有 一 组 实验 数据 (x[i], yl )， 我 们 知道 它们 之 间 的 函数 关系 :y = f(x)， 通 过 这 些 已 
知 信 息 ， 需 要 确定 函数 中 的 一 些 参 数 项 。 例 如 ， 如 果 f 是 一 个 线 型 画 数 f(x) = kx+b， 
那么 参数 K 和 /就 是 我 们 需要 确定 的 值 。 如 果 将 这 些 参数 用 p 表示 的 话 ， 那 么 我 们 就 
是 要 找到 一 组 *p 值 使 得 如 下 公式 中 的 S 酚 数 最 小 : 

S(p) = 》 [yi — f(zi, p)? 


i=1 
这 种 算法 被 称 之 为 最 小 二 乘 拟 合 (Leastrsquare fitting). 


scipy 中 的 子 画 数 库 optimize 已 经 提供 了 实现 最 小 二 乘 拟 合算 法 的 画 数 leastsq。 下 面 
是 用 leastsq 进 行 数据 拟 合 的 一 个 例子 : 


# -*- coding: utf-8 -*- 

import numpy as np 

from scipy.optimize import leastsq 
import pylab as pl 


def func(x, p): 


数据 拟 合 所 用 的 函数 : A*sin(2*pi*k*x + theta) 


A, k, theta = p 
return A*np.sin(2*np.pi*k*x+theta) 


def residuals(p, y, x): 
实验 数据 x， y 和 拟 合 函数 之 间 的 差 ，p 为 拟 合 需要 找到 的 系数 


return y - func(x, p) 


x = np.linspace(0, -2*np.pi, 100) 
A, k, theta = 10, 0.34, np.pi/6é # 真实 数据 的 函数 参数 


yO = func(x, [A, k, theta]) # 真实 数据 
yi = yO + 2 * np.random.randn(len(x)) # 加 入 噪声 之 后 的 实验 数据 
pO = [7, 0.2, 0] # 第 一 次 猜测 的 函数 拟 合 参数 


# 调用 leastsq 进 行 数据 拟 合 

# residuals 为 计算 误差 的 函数 

# pg 为 拟 合 参数 的 初始 值 

# args 为 需要 拟 合 的 实验 数据 

plsq = leastsq(residuals, pO, args=(y1, x)) 


print u" 真 实 参 数 :"， [A, k, theta] 
print u" 拟 合 人 参数 "，plsq[90] # 实验 数据 拟 合 后 的 参数 


pl.plot(x，y9，label=u" 真 实数 据 ") 
p1.plot(x，y1，1labe1=u" 带 噪声 的 实验 数据 " ) 
plL,.pLot(x，func(x，plsq[9])，1Labe1L=u" 拟 合 数据 " ) 
pl.legend() 

pl.show( ) 


PIF PR NEWAaANWARe-TEKRARM, CAITER A, k, theta, 7 
对 应 振幅 、 频 率 、 相 角 。 假 设 我 们 的 实验 数据 是 一 组 包含 噪声 的 数据 x, y1, BH 
y1 是 在 真实 数据 y0 的 基础 上 加 入 噪声 的 到 了 。 


通过 leastsq 画 数 对 带 噪声 的 实验 数据 x, y1 进 行 数 据 拟 合 ， 可 以 找到 x 和 真实 数据 y0 
之 间 的 正弦 关系 的 三 个 参数 : A, k, theta。 下 面 是 程序 的 输出 : 


# -*- coding: utf-8 -*- 
# AEP AS HrminsaKsenvzs 


import scipy.optimize as opt 
import numpy as np 


def test_fmin_convolve(fminfunc, x, h, y, yn, xO): 
x (*) h = y，(*) 表 示 疮 积 

yn 为 在 y 的 基础 上 添加 一 些 干扰 噪声 的 结 

Xx0 为 求解 x 的 初始 值 


def convolve_func(h): 
计算 yn - x (*) h 的 power 
fmin 将 通过 计算 使 得 此 power 最 小 


return np.sum((yn - np.convolve(x, h))**2) 


# 调用 fmin 函 数 ， 以 x0 为 初始 值 
ho = fminfunc(convolve_func, x0) 


print fminfunc. name _ 

print "--------------------- i 

# 输出 x (*) ho 和 y 之 间 的 相对 误差 

print "error of y:", np.sum((np.convolve(x, h@)-y)**2)/np.sum(\ 
# 输出 ho 和 h 之 间 的 相对 误差 

print "error of h:", np.sum( (ho-h)**2)/np.sum(h**2) 

print 


def test_n(m, n, nscale): 
随机 产生 x，h，y，yn，xX09 等 数列 ， 调 用 各 种 fmin 函 数 求 解 b 
m 为 x 的 长 度 ，n 为 h 的 长 度 ，nscale 为 干扰 的 强度 


x = np.random.rand(m) 
h = np.random.rand(n) 
y = np.convolve(x, h) 
yn = y + np.random.rand(len(y)) * nscale 
x0 = np.random.rand(n) 


test_fmin_convolve(opt.fmin, x, h, y, yn, x0) 
test_fmin_convolve(opt.fmin_powell, x, h, y, yn, x0) 
test_fmin_convolve(opt.fmin_cg, x, h, y, yn, x0) 
test_fmin_convolve(opt.fmin_bfgs, x, h, y, yn, xO) 


if name == " main_": 
test_n(200, 20, 0.1) 


«| —_ 








下 面 是 程序 的 输出 : 


error of y: 0.00568756699607 
error of h: 0.354083287918 


fmin_powell 


error of y: ©.000116114709857 
error of h: 0.000258897894009 


error of y: 0.000111220299615 
error of h: 0.000211404733439 


fmin_bfgs 


error of y: ©.000111220251551 
error of h: 0.000211405138529 


非 线 性 方程 组 求解 


optimize 库 中 的 fsolve 画 数 可 以 用 来 对 非 线 性 方程 组 进行 求解 。 它 的 基本 调用 形式 如 
下 : 


fsolve(func, x0) 


func(x) 是 计算 方程 组 误差 的 函数 ， 它 的 参数 x 是 一 个 矢量 ， 表 示 方 程 组 的 各 个 未 知 
数 的 一 组 可 能 解 ，func 返 回 将 x 代入 方程 组 之 后 得 到 的 误差 ; x0 为 未 知 数 矢 量 的 初 
始 值 。 如 果 要 对 如 下 方程 组 进行 求解 的 话 : 

e f1(u1,u2,u3) = 0 


e f2(u1,u2,u3) = 0 
e f3(u1,u2,u3) = 0 


那么 func 可 以 如 下 定义 : 
def func(x): 


u1,u2,U3 = x 
return [f1(u1,u2,u3), f2(u1,u2,u3), f3(u1,u2,u3) ] 


下 面 是 一 个 实际 的 例子 ， 求 解 如 下 方程 组 的 解 : 


e 5*x1+3=0 
e 4x0x0 - 2sin(x1x2) = 0 
e x1*x2-1.=0 


程序 如 下 : 


from scipy.optimize import fsolve 
from math import sin,cos 


x0 = float(x[0]) 
float(x[1]) 
float(x[2]) 
return [ 
5 xis, 
4*x0*x0 - 2*sin(x1*x2), 
MEEK 2 co eS 


def f(x): 


] 
result = fsolve(f, [1,1,1]) 


print result 
print f(result) 


输出 为 : 


[-0.70622057 -0.6 Sens 
[0.0, -9.1260332624187868e-14, 5.3290705182007514e-15] 


FAFfsolveR A AAR, ZBRNSMA Ba, ARE PARP 
素 计算 的 话 ， 计 算 速度 将 会 有 所 降低 ， 因 此 这 里 先 用 float 范 数 将 数组 中 的 元 素 转 换 
为 Python 中 的 标准 浮 点 数 ， 然 后 调用 标准 math 库 中 的 画 数 进行 运算 。 


在 对 方程 组 进行 求解 时 ，fsolve 会 自动 计算 方程 组 的 雅 可 比 和 矩阵 ， 如 果 方 程 组 中 的 
未 知 数 很 多 ， 而 与 每 个 方程 有 关 的 未 知 数 较 少 时 ， 即 雅 可 比 和 矩阵 比较 稀 巩 时 ， 传 递 
一 个 计算 雅 可 比 矩 阵 的 函数 将 能 大 幅度 提高 运算 速度 。 笔 者 在 一 个 模拟 计算 的 程序 
中 需要 大 量 求解 近 有 50 个 未 知 数 的 非 线性 方程 组 的 解 。 每 个 方程 平均 与 6 个 未 知 数 
相关 ， 通 过 传递 雅 可 比 和 矩阵 的 计算 画 数 使 计算 速度 提高 了 4 倍 。 

AE BY) Ee FB rE 

HT Li 2— IMS BUI EARI, CANT TAOS RSS ERM 
mia, ALXUFSTRAN SR. GUANA MAAN f2,f3F0AR MA 
uU1,U2,uU3 的 雅 可 比 矩 阵 如 下 : 
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在 矢量 x 点 上 的 雅 可 比 和 矩阵 。 由 于 这 个 例子 中 未 知 数 很 少 ， 因 此 程序 计算 雅 可 比 矩 
阵 并 不 能 带 来 计算 速度 的 提升 。 


# -*- coding: utf-8 -*- 
from scipy.optimize import fsolve 
from math import sin,cos 
def f(x): 
x0 = float(x[0]) 
x1 = float(x[1]) 
x2 = float(x[2]) 
return [ 
5*x1+3, 
4*x0*x0 - 2*sin(x1*x2), 
MAAK 2 5 


def j(x): 

= float(x[0]) 
x1 = float(x[1]) 
x2 = float(x[2]) 


return [ 
[0, 5, 0], 
[8*x0, -2*x2*cos(x1*x2), -2*x1*cos(x1*x2)], 
LO 2I] 

] 


result = fsolve(f, [1,1,1], fprime=j) 
print result 
print f(result) 


B-Spline 样 条 曲线 


interpolate 库 提供 了 许多 对 数据 进行 插值 运算 的 函数 。 下 面 是 使 用 直线 和 B-Spline 
对 正弦 波 上 的 点 进行 插值 的 例子 。 


# -*- coding: utf-8 -*- 
import numpy as np 

import pylab as pl 

from scipy import interpolate 


X 
y 


np.linspace(0, 2*np.pi+np.pi/4, 10) 
np.sin(x) 


x_new = np.linspace(0, 2*np.pit+np.pi/4, 100) 
f_linear = interpolate.interpid(x, y) 

tck = interpolate.splrep(x, y) 

y_bspline = interpolate.splev(x_new, tck) 


pl.plot(x, y, "o", label=u" 原 始 数 据 ") 
pl.plot(x_new，f_linear(x_new)，label=u" 线 性 插值 ") 
pl.plot(x_new，y_bspline，1label=u"B-spline 插 值 ") 
pl.legend() 

pl.show( ) 


o o 原始 数据 
— 线性 插值 
一 一 ”B-spline 插值 





使 用 interpolate 库 对 正弦 波 数 据 进行 线性 插值 和 B-Spline 插 值 


在 这 上段 程序 中 ， 通 过 interp1d 函 数 直 接 得 到 一 个 新 的 线性 插值 琅 数 。 而 B-Spline 插 值 
运算 需要 先 使 用 splrep 画 数 计算 出 B-Spline 曲 线 的 参数 ， 然 后 将 参数 传递 给 splev 画 
数 计算 出 各 个 取样 点 的 插值 结果 。 


数值 积分 


数值 积分 是 对 定 积分 的 数值 求解 ， 例 如 可 以 利用 数值 积分 计算 某 个 形状 的 面积 。 下 
面 让 我 们 来 考虑 一 下 如 何 计算 半 径 为 1 的 半圆 的 面积 ， 根 据 圆 的 面积 公式 ， 其 面积 
应 该 等 于 Pl2。 单 位 半圆 曲线 可 以 用 下 面 的 函数 表示 : 


def half_circle(x): 
return (1-x**2)**0.5 


下 面 的 程序 使 用 经 典 的 分 小 矩形 计算 面积 总 和 的 方式 ， 计 算出 单位 半圆 的 面积 : 


>>> N 10000 

>>> X np.linspace(-1, 1, N) 

>>> dx = 2.0/N 

>>> y = half_circle(x) 

>>> dx * np.sum(y[:-41] + y[1:]) # 面积 的 两 倍 
3.1412751679988937 


利用 上 述 方 式 计 算出 的 圆 上 一 系列 点 的 坐标 ， 还 可 以 用 numpy.trapz 进 行 数 值 积 
分 : 


>>> import numpy as np 
>>> np.trapz(y, x) * 2 # 面积 的 两 倍 
3.1415893269316042 


此 函数 计算 的 是 以 x,y 为 顶点 坐标 的 折线 与 X 轴 所 夹 的 面积 。 同 样 的 分 割 点 数 ，trapz 
函数 的 结果 更 加 接近 精确 值 一 些 。 


如 果 我 们 调用 scipy.integrate 库 中 的 quad 函 数 的 话 ， 将 会 得 到 非常 精确 的 结果 : 
>>> from scipy import integrate 
>>> pi_half, err = integrate.quad(half_circle, -1, 1) 


>>> pi_half*2 
3.1415926535897984 


SBERONK a LA SRigAquadwWArm, 7A SIWRAE, integratextz 
ET dblquadWwX#toT—BERD, tplquad HAA TEE ERD. FAAA AA 
ERA 42 A Al Adblquad žk Ask. 


单位 半球 上 的 点 (x,y,z) 符 合 如 下 方程 : 
r +y +z =l 
Atk Ay LALAN F E 2 Bit (x,y) A it AR E ra AzA PS: 


def half_sphere(x, y): 
return (1-x**2-y**2)**0.5 


X-Y 轴 平面 与 此 球体 的 交 线 为 一 个 单位 圆 ， 因 此 积分 区 间 为 此 单位 圆 ， 可 以 考虑 为 X 
轴 坐 标 从 -1 到 1 进行 积分 ， 而 Y 轴 从 -half_circle(x) 到 half_circle(x) 进行 积分 ， 于 是 
可 以 调用 dblquad 画 数 : 


>>> integrate.dblquad(half_sphere, -1, 1, 

lambda x:-half_circle(x), 

lambda x:half_circle(x) ) 
>>> (2.0943951023931988, 2.3252456653390915e-14) 
>>> np.pi*4/3/2 # 通过 球体 体积 公式 计算 的 半球 体积 
2.0943951023931953 


dblquad 画 数 的 调用 方式 为 : 


dblquad(func2d, a, b, gfun, hfun) 


xt Ffunc2d(x,y)HM#ToI BR, Hha bh g Ex, Mgfun(x)ll 
hfun(x) 为 变量 y 的 积分 区 间 。 


半球 体积 的 积分 的 示意 图 如 下 : 


1.00 





1.00 -1.00 


半球 体积 的 双重 定 积分 示意 图 


X 轴 的 积分 区 间 为 -1.0 到 1.0， 对 于 X=x0 时 ， 通 过 对 Y 轴 的 积分 计算 出 切面 的 面积 ， 
因此 Y 轴 的 积分 区 间 如 图 中 红色 点 线 所 示 。 


解 党 微分 方程 组 

scipy.integrate 库 提供 了 数值 积分 和 常 微分 方程 组 求解 算法 odeint。 下 面 让 我 们 来 看 
看 如 何 用 odeint 计 算 洛 仓 兹 吸引 子 的 轨迹 。 洛 仓 兹 吸引 子 由 下 面 的 三 个 微分 方程 定 
l: 


= = o(y—=z) 


zip =2)—y 


dz 
= ry — Bz 
ae 


洛 仑 益 吸 引子 的 详细 介绍 


http://ozhang.lamost.org/website/archives/lorenz_attactor 


这 三 个 方程 定义 了 三 维 空间 中 各 个 坐标 点 上 的 速度 矢量 。 从 某 个 坐标 开始 治 着 速度 
矢量 进行 积分 ， 就 可 以 计算 出 无 质量 点 在 此 空间 中 的 运动 轨迹 。 其 中 o, P, B AED 
常数 ， 不 同 的 参数 可 以 计算 出 不 同 的 运动 轨迹 : — y0, z(t) 当 参 数 为 某 些 值 
时 ， 轨 迹 出 现 锡 钝 现象 : 即 微小 的 初 值 差别 也 会 显著 地 影响 运动 轨迹 。 下 面 是 洛 仑 
益 吸 引子 的 轨迹 计算 和 绘制 程序 : 


# -*- coding: utf-8 -*- 
from scipy.integrate import odeint 
import numpy as np 


def ee ta poke be 
给 出 位 置 撩 量 w， 和 三 个 参数 p，r，b 计 算出 
s dadi, ai, dz/dt 的 值 
Z = W 
a 和 
return np.array([p*(y-x), x*(r-z)-y, x*y-b*z]) 


t = np.arange(0, 30, 0.01) # 创建 时 间 点 

# 调用 ode 对 lorenz 进 行 求解 ， 用 两 个 不 同 的 初始 值 

track1 = odeint(lorenz, (0.0, 1.00, 0.0), t, args=(10.0, 28.0, 
track2 = odeint(lorenz, (0.0, 1.01, 0.0), t, args=(10.0, 28.0, 


WW 
loo} 


# 绘图 
from mpl_toolkits.mplot3d import Axes3D 
import matplotlib.pyplot as plt 


fig = plt.figure() 

ax = Axes3D(fig) 

ax.plot(track1[:,0], track1i[:,1], track1[:,2]) 
ax.plot(track2[:,0], track2[:,1], track2[:,2]) 
pit .show( ) 
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用 odeint 沙 数 对 洛 仑 益 吸 引子 微分 方程 进行 数值 求解 所 得 到 的 运动 轨迹 
我 们 看 到 即使 初始 值 只 相差 0.01， 两 条 运动 轨迹 也 是 完全 不 同 的 。 


在 程序 中 先 定义 一 个 lorenz 函 数 ， 它 的 任务 是 计算 出 某 个 位 置 的 各 个 方向 的 微分 
值 ， 这 个 计算 直接 根据 洛 耸 益 吸引 子 的 公式 得 出 。 然 后 调用 odeint， 对 微分 方程 求 


解 ，odeint 有 许多 参数 ， 这 里 用 到 的 四 个 参数 分 别 为 : 


1. lorenz， 它 是 计算 某 个 位 移 上 的 各 个 方向 的 速度 (位 移 的 微分 ) 
2. (0.0, 1.0, 0.0)， 位 移 初 始 值 。 计 算 常 微分 方程 所 需 的 各 个 变量 的 初始 值 
3.t, 表示 时 间 的 数组 ，odeint 对 于 此 数组 中 的 每 个 时 间 点 进行 求解 ， 得 出 所 有 时 


间 点 的 位 置 


4. args, 这 些 参数 直接 传递 给 lorenz 辑 数 ， 因 此 它们 都 是 常量 


滤波 器 设计 


scipy.signal 库 提供 了 许多 信号 处 理 方面 的 范 数 。 在 这 一 节 ， 让 我 们 来 看 看 如 何 利用 
signal 库 设计 滤波 器 ， 查看 滤波 器 的 频率 响应 ， 以 及 如 何 使 用 滤波 器 对 信号 进行 滤 


Xo 


假设 如 下 导入 signal 库 : 


>>> import scipy.signal as signal 


下 面 的 程序 设计 一 个 带 通 ||R 滤 波 器 : 


>>> b, a = signal.iirdesign([0.2, 0.5], [0.1, 0.6], 2, 40) 


这 个 滤波 器 的 通 带 为 0.210 到 0.5f0， 阻 带 为 小 于 0.11f0 和 大 于 0.6f0， 其 中 f0 为 1/2 的 信 
号 取样 频率 ， 如 果 取 样 频率 为 8kHz 的 话 ， 那 么 这 个 带 通 滤波 器 的 通 带 为 800Hz 到 
2kHz。 通 带 的 最 大 增益 衰减 为 2dB， 阻 带 的 最 小 增益 衰减 为 40dB， 即 通 带 的 增益 浮 
动 在 2dB 之 内 ， 阻 带 至 少 有 40dB 的 衰减 。 


iirdesgin 返 回 的 两 个 数组 b 和 a， 它们 分 别 是 IIR 滤 波 器 的 分 子 和 分 母 部 分 的 系数 。 其 
中 a[0] 恒 等 于 1。 


下 面 通过 调用 freqz 计 算 所 得 到 的 滤波 器 的 频率 响应 : 


>>> w, h = signal.freqz(b, a) 


freqz 返 回 两 个 数组 w 和 h， 其 中 w 是 圆 频 率 数 组 ， 通 过 wW/pi*f0 可 以 计算 出 其 对 应 的 实 
际 频 率 。h 是 w 中 的 对 应 频率 点 的 响应 ， 它 是 一 个 复数 数组 ， 其 幅 值 为 滤波 器 的 增 
益 ， 相 和 角 为 滤波 器 的 相位 特性 。 


下 面 计算 h 的 增益 特性 ， 并 转换 为 dB 度量 。 由 于 h 中 存在 幅 值 几乎 为 0 的 值 ， 因 此 先 
用 clip 阔 数 对 其 裁剪 之 后 ， 再 调用 对 数 函 数 ， 避 人 免 计 算出 错 。 


>>> power = 20*np.log10(np.clip(np.abs(h), 1e-8, 1e100)) 


通过 下 面 的 语句 可 以 绘制 出 滤波 器 的 增益 特性 图 ， 这 里 假设 取样 频率 为 8kHz : 


>>> pl.plot(w/np.pi*4000, power) 


在 实际 运用 中 为 了 测量 未 知 系统 的 频率 特性 ， 经 单 将 频率 扫描 波 输 入 到 系统 中 ， 观 
察 系统 的 输出 ， 从 而 计算 其 频率 特性 。 下 面 让 我 们 来 模拟 这 一 过 程 。 


为 了 调用 chirp 函 数 以 产生 频率 打 描 波形 的 数据 ， 首 先 需 要 产生 一 个 等 差 数组 代表 取 
样 时 间 ， 下 面 的 语句 产生 2 秒 钟 取样 频率 为 8KHz 的 取样 时 间 数 组 : 


>>> t = np.arange(0, 2, 1/8000.0) 


Ama chirps 2024) p BY 3 13 FRAG SG: 


>>> sweep = sSignal.chirp(t, f0=0, t1 = 2, f1=4000.0) 


频率 扫描 波 的 开始 频率 f0 为 OHz， 结 束 频 率 f1 为 4kHz， 到 达 4kHz 的 时 间 为 2 秒 ， 使 
用 数组 t 作 为 取样 时 间 点 。 


下 面 通过 调用 |filter 函 数 计算 sweep 波 形 经 过 带 通 滤波 器 之 后 的 结果 : 


>>> out = signal.lfilter(b, a, sweep) 


lfilter 内 部 通过 如 下 算式 计算 IIR 滤 波 器 的 输出 : 


通过 如 下 算式 可 以 计算 输入 为 x 时 的 滤波 器 的 输出 ， 其 中 数组 x 代表 输入 信和 号，y 代 
表 输 出 信号 : 


yln] = b[0]2[n] + b[1]a2[n — 1] +--- + b[P]a[n — P] 
— alljyln — 1] — al2]jy[n 一 3) —-+-—alQ]y[n — Q] 


为 了 和 系统 的 增益 特性 图 进行 比较 ， 需 要 获取 输出 波形 的 包 络 ， 因 此 下 面 先 将 输出 
波形 数据 转换 为 能 量 值 : 


>>> out = 20*np.log10(np.abs(out) ) 


为 了 计算 包 络 ， 找 到 所 有 能 量 大 于 前 后 两 个 取样 点 (局 部 最 大 点 ) 的 下 标 : 

>>> index = np.where(np.logical_and(out[1:-1] > out[:-2], out[1:-1 
«| Se 
最 后 将 时 间 转 换 为 对 应 的 频率 ， 绘 制 所 有 局 部 最 大 点 的 能 量 值 : 





>>> pl.plot(t[index]/2.0*4000, out[index] ) 


下 图 显示 freqz 计 算 的 频 潜 和 频率 扫描 波 得 到 的 频率 特性 ， 我 们 看 到 果 是 一 


o 


$ 


freqz 计 算 的 滤波 器 频谱 


500 1000 1500 2000 2500 3000 3500 4900 


频率 扫描 波 测量 的 滤波 器 频谱 


500 1000 1500 2000 2500 3000 3500 4900 
频率 (Hz) 


带 通 IIR 滤 波 器 的 频率 响应 和 频率 扫描 波 计 算 的 结果 比较 
计算 此 图 的 完整 源 程序 请 查看 附录 中 的 带 通 滤波 器 设计 o 


FaWeave#tr ACE 


Python 作为 动态 语言 其 功能 虽然 强大 ， 但 是 在 数值 计算 方面 有 一 个 最 大 的 缺点 : 速 
度 不 够 快 。 在 Python 级 别 的 循环 和 计算 的 速度 只 有 C 话 言 程 序 的 百 分 之 一 。 因 此 才 
有 了 NumPy, SciPy 这 样 的 事 数 库 ， 将 高 度 优 化 的 C、Fortran 的 画 数 库 进 行 包 装 ， 以 
供 Python 程 序 调用 。 如 果 这 些 高 度 优 化 的 函数 库 无 法 实现 我 们 的 算法 ， 必 须 从 头 开 

台 写 循环 、 计 算 的 话 ， 那 么 用 Python 来 做 显然 是 不 合适 的 。 因 此 SciPy 提 供 了 快速 
调用 C++ 语言 程序 的 方法 -- Weave。 下 面 是 对 NumPy 的 数组 求 和 的 例子 : 


# -*- coding: utf-8 -*- 
import scipy.weave as weave 
import numpy as np 

import time 


def my_sum(a): 
n=int(len(a) ) 
code="! mW 

int i; 


double counter; 
counter =0; 
for(i=0;i<n;i++){ 
counter=counter+a(i); 


} 


return_val=counter; 


err=weave.inline( 
code, ['a','n'], 
type_converters=weave.converters.blitz, 
compiler="gcc" 

) 


return err 


a = np.arange(0, 10000000, 1.0) 
# 先 调 用 一 次 my_sum，weave 会 自动 对 C 语 言 进行 编译 ， 此 后 直接 运行 编译 之 后 的 代码 
my_sum(a) 


start = time.clock() 

for i in xrange(100): 
my_sum(a) # 直接 运行 编译 之 后 的 代码 

print "my_sum:", (time.clock() - start) / 100.0 


start = time.clock() 
for i in xrange(100): 

np.sum( a ) # numpy#isum, # žm tt EC4 E RF 
print "np.sum:", (time.clock() - start) / 100.0 


start = time.clock() 

print sum(a) # Python 内 部 函数 Sum 通 过 数组 a 的 迭代 接口 访问 其 每 个 元 素 ， 因 此 速度 

print "sum:", time.clock() - start 
BHEE 


此 例子 在 我 的 电脑 上 的 运行 结果 为 : 





>>> from sympy import * 


封面 上 的 经 典 公式 


本 书 的 封面 上 的 公式 : 

e" +1=0 

叫做 欧 拉 恒等式 ， 其 中 e 是 自然 指数 的 底 ，j 是 虚数 单位 ， 7 是 圆周 率 。 此 公式 被 誉 
为 数学 最 奇妙 的 公式 ， 它 将 5 个 基本 数学 常数 用 加 法 、 乘 法 和 乔 运 算 联 系 起 来 。 下 
面 用 SymPy 验 证 一 下 这 个 公式 。 

载 入 的 符号 中 ，E 表 示 自 然 指数 的 底 ，| 表 示 虚 数 单位 ，pi 表 示 圆 周 率 ， 因 此 上 述 的 
公式 可 以 直接 如 下 计算 : 


>>> E**(I*pi)+1 
0 


欧 拉 恒等式 可 以 下 面 的 公式 进行 计算 ， 

e" = cosg +isin z 

为 了 用 SymPy 求 证 上 面 的 公式 ， 我 们 需要 引入 变量 x。 在 SymPy 中 ， 数 学 符号 是 
Symbol 类 的 对 象 ， 因 此 必须 先 创建 之 后 才能 使 用 : 


>>> x = Symbol('x') 


expandWRMAaLYANRA, RMA CKRAE*(pi)ixire : 


>>> expand( E**(1I*x) ) 
exp(I*x) 


没有 成 功 ， 只 是 换 了 一 种 写法 而 已 。 这 里 的 exp 不 是 math.exp 或 者 humpy.exp， 而 
是 sympy.exp， 它 是 一 个 类 ， 用 来 表述 自然 指数 函数 。 


expand 函 数 有 关键 宇 参 数 complex， 当 它 为 True 时 ，expand 将 把 公式 分 为 实数 和 虚 
数 两 个 部 分 : 


>>> expand(exp(I*x), complex=True) 
I*exp(-im(x))*sin(re(x)) + cos(re(x))*exp(-im(x) ) 


这 次 得 到 的 结果 相当 复杂 ， 其 中 sin, cos, re, im 都 是 sympy 定 义 的 类 ，re 表 示 取 实数 
部 分 ，im 表 示 取 虚数 部 分 。 显 然 这 里 的 运算 将 符号 x 当 作 复数 了 。 为 了 指定 符号 x 必 
须 是 实数 ， 我 们 需要 如 下 重新 定义 符号 x : 


>>> X = Symbol("x", real=True) 
>>> expand(exp(I*x), complex=True) 
I*sin(x) + cos(x) 


终于 得 到 了 我 们 需要 的 公式 。 那 么 如 何 证 明 它 呢 。 我 们 可 以 用 泰勒 多 项 式 展开 : 


>>> tmp = series(exp(I*x), x, ©, 10) 
>>> pprint(tmp) 
4 


2 3 5 6 7 8 9 

x aX x TX x TX X I*x 
1 + I*x - -- - ---- + -- + ---- - --- - ---- + ----- + ------ + 0() 
2 6 24 120 720 5040 40320 362880 





series 是 泰勒 展开 函数 ，pprint 将 公式 用 更 好 看 的 格式 打印 出 来 。 下 面 分 别 获 得 tmp 
的 实 部 和 虚 部 ， 分 别 和 cos(x) 和 sin(x) 的 展开 公式 进行 比较 : 


&gt;&gt;&gt; pprint(re(tmp) ) 
6 8 


2 A 
x X X X 
T eO 0 ee 


2 24 720 40320 


&gt;&gt;&gt; pprint( series( cos(x), x, 9, 10) ) 
2 4 6 8 


1 = ee aa a 一 一 一 十 -= 一 -一 十 OX * 16)) 


&gt;&gt;&gt; pprint(im(tmp) ) 


3 5 7 9 
X X X X 
Oe On 


6 120 5040 362880 


&gt;&gt;&gt; pprint(series(sin(x), x, 0, 10)) 


3 5 1 9 
X X X X 
X- -- + --- - ---- + ------ ar OO< * 10) 


6 120 5040 362880 


球体 体积 


在 用 SciPy 数 值 积分 一 节 我 们 介绍 了 如 何 使 用 数值 定 积 分 计算 球体 的 体积 ， 而 
SympPy 的 符号 积分 函数 integrate 则 可 以 帮助 我 们 进行 符号 积分 。integrate 可 以 进行 
不 定 积 分 : 


>>> integrate(x*sin(x), x) 
-x*cos(x) + sin(x) 


如 果 指 定 x 的 取 值 范围 的 话 ，integrate 则 进行 定 积分 运算 : 


>>> integrate(x*sin(x), (x, 9, 2*pi)) 
-2*pi 


为 了 计算 球体 体积 ， 首 先 让 我 们 来 看 看 如 何 计算 圆 形 面积 ， 假 设 圆 形 的 半径 为 r， 则 
贺 上 任意 一 点 的 Y 坐 标 辑 数 为 : 


y(r) = Vr? — r? 


At Bia eet bE A ATRAEN ER, ERR SB 
使 用 symbols 画 数 一 次 创建 多 个 符号 : 


>>> X, y, r = symbols('x,y,r') 
>>> 2 * integrate(sqrt(r*r-x**2), (x, =r, r)) 
2 mmntegra (r 2E 2) (M2 OaE) 


很 遗憾 ，integrate 画 数 没有 计算 出 结果 ， 而 是 直接 返回 了 我 们 输入 的 算式 。 这 是 因 
为 SymPy 不 知道 r 是 大 于 0 的 ， 如 下 重新 定义 r， 就 可 以 得 到 正确 答案 了 : 


>>> r = symbols('r', positive=True) 

>>> circle area = 2 * integrate(sqrt(r**2-x**2), (x, -r, r)) 
>>> circle_area 

Dil ne 2 


接 下 来 对 此 面积 公式 进行 定 积 分 ， 就 可 以 得 到 球体 的 体积 ， 但 是 随 着 X 轴 坐标 的 变 
化 ， 对 应 的 切面 的 的 半径 会 发 生变 化 ， 现 在 假设 X 轴 的 坐标 为 X， 球 体 的 半径 为 
则 x 处 的 切面 的 半径 为 可 以 使 用 前 面 的 公式 y(x) 计 算出 。 
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1.00 -1.00 
球体 体积 的 双重 定 积 分 示意 图 
因此 我 们 需要 对 circle_area 中 的 变量 r 进 行 替 代 : 


>>> circle_area = circle_area.subs(r, sqrt(r**2-x**2)) 
>>> circle_area 
BI (0 2 x 2) 


用 subs 进 行 算式 替换 


subs 函 数 可 以 将 算式 中 的 符号 进行 蔡 换 ， 它 有 3 种 调用 方式 : 


e expression.subs(x, y) : 将 算式 中 的 x 替 换 成 y 
e expression.subs({x:y,u:v}) : 使 用 字典 进行 多 次 替换 
e expression.subs([(x,y),(u,v)]) : 使 用 列表 进行 多 次 替换 


请 注意 多 次 蔡 换 是 顺序 执行 的 ， 因 此 : 


expression.sub([(x,y),(y,x)]) 


并 不 能 对 两 个 符号 x,y 进 行 交换 。 


然后 对 circle_area 中 的 变量 x 在 区 间 -r 到 r 上 进行 定 积 分 ， 得 到 球体 的 体积 公式 : 


>>> integrate(circle area, (x, -r, r)) 
47 pini 
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matplotlib- 绘 制 精美 的 图 表 


matplotlib 是 python 最 著名 的 绘图 库 ， 它 提供 了 一 整套 和 matlab 相 似 的 命 合 APIl， 十 
分 适合 交互 式 地 进行 制图 。 而 且 也 可 以 方便 地 将 它 作 为 绘图 控件 ， 伐 入 GUI 应 用 程 
序 中 。 


它 的 文档 相当 完备 ， 并 且 Gallery 页 面 中 有 上 百 幅 缩 略 图 ， 打 开 之 后 都 有 源 程序 。 
因此 如 果 你 需要 绘制 某 种 类 型 的 图 ， 只 需要 在 这 个 页 面 中 浏览 /复制 /粘贴 一 下 ， 基 
本 上 都 能 搞定 。 


本 章节 作为 matplotlib 的 入 门 介 绍 ， 将 较为 深入 地 挖掘 几 个 例子 ， 从 中 理解 和 学 习 
matplotlib 绘 图 的 一 些 基 本 概念 。 


快速 绘图 


matplotlib 的 pyplot 子 库 提 供 了 和 matlab 类 似 的 绘图 API， 方 便 用 户 快速 绘制 2D 图 
表 。 让 我 们 先 来 看 一 个 简单 的 例子 : 


# -*- coding: utf-8 -*- 
import numpy as np 
import matplotlib.pyplot as plt 


= np.linspace(0, 10, 1000) 
y = np.sin(x) 
z = np.cos(x**2) 


plt.figure(figsize=(8,4)) 

plt.plot(x,y, label="$sin(x)$", color="red", Linewidth=2) 
plt.plot(x,z,"b--",label="$cos(x2)$") 
plt.xlabel("Time(s)") 

plt.ylabel("Volt") 

plt.title("PyPlot First Example") 

plt.ylim(-1.2,1.2) 

plt.legend() 

plt.show( ) 
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PyPlot First Example 





调用 pyplot 库 快速 将 数据 绘制 成 曲线 图 
matplotlib 中 的 快速 绘图 的 函数 库 可 以 通过 如 下 语句 载 人 : 


import matplotlib.pyplot as plt 


pylab 模 块 
matplotlib 还 提供 了 名 为 pylab 的 模块 ， 其 中 包括 了 许多 numpy 和 pyplot 中 常用 的 函 
数 ， 方 便 用 户 快速 进行 计算 和 绘图 ， 可 以 用 于 IPython 中 的 快速 交互 式 使 用 。 


接 下 来 调用 figure 创 建 一 个 绘图 对 象 ， 并 且 使 它 成 为 当前 的 绘图 对 象 。 


plt.figure(figsize=(8,4)) 


也 可 以 不 创建 绘图 对 象 直 接 调 用 接 下 来 的 plot 函 数 直接 绘图 ，matplotlib 会 为 我 们 自 
动 创建 一 个 绘图 对 象 。 如 果 需 要 同时 绘制 多 幅 图 表 的 话 ， 可 以 是 给 figure 传 递 一 个 
整数 参数 指定 图 标的 序号 ， 如 果 所 指定 序号 的 绘图 对 象 已 经 存在 的 话 ， 将 不 创建 新 
的 对 象 ， 而 只 是 让 它 成 为 当前 绘图 对 象 。 


通过 figsize 参 数 可 以 指定 绘图 对 象 的 宽度 和 高 度 ， 单 位 为 英寸 ; dpi 参 数 指定 绘图 对 
象 的 分 辩 率 ， 即 每 英寸 多 少 个 像素 ， 缺 省 值 为 80。 因 此 本 例 中 所 创建 的 图 表 窗 口 的 
宽度 为 8*80 = 640 像 素 。 


但 是 用 工具 栏 中 的 保存 按钮 保存 下 来 的 png 图 像 的 大 小 是 800*400 像 素 。 这 是 因为 保 
存 图 表 用 的 函数 savefig 使 用 不 同 的 DPI 配 置 ，savefig 函 数 也 有 一 个 dpi 参 数 ， 如 果 不 
设置 的 话 ， 将 使 用 matplotlib 配 置 文件 中 的 配置 ， 此 配置 可 以 通过 如 下 语句 进行 查 
看 ， 关 于 配置 文件 将 在 后 面 的 章节 进行 介绍 : 


>>> import matplotlib 
>>> matplotlib.rcParams["savefig.dpi" ] 
100 


下 面 的 两 行程 序 通过 调用 plot 函 数 在 当前 的 绘图 对 象 中 进行 绘图 : 


plt.plot(x,y, label="$sin(x)$", color="red", Linewidth=2) 
plt.plot(x,z,"b--",label="$cos(x42)$") 


plot 画 数 的 调用 方式 很 灵活 ， 第 一 句 将 x,y 数 组 传递 给 plot 之 后 ， 用 关键 字 参 数 指定 
各 种 属性 : 


e label: 给 所 绘制 的 曲线 一 个 名 字 ， 此 名 字 在 图 示 (legend) 中 显示 。 只 要 在 字符 
串 前 后 添加 "$" 符 号 ，matplotlib 就 会 使 用 其 内 徐 的 latex 引 擎 绘制 的 数学 公式 。 

e color : 指定 曲线 的 颜色 

e linewidth : 指定 曲线 的 宽度 


第 二 名 直接 通过 第 三 个 参数 "b--" 指 定 曲线 的 颜色 和 线 型 ， 这 个 参数 称 为 格式 化 参 
数 ， 它 能 够 通过 一 些 易 记 的 符号 快速 指定 曲线 的 样式 。 其 中 b 表 示 蓝 色 ，"--" 表 示 线 
型 为 虚线 。 在 IPython 中 输入 "plt.plot?" 可 以 查看 格式 化 字符 串 的 详细 配置 。 


接 下 来 通过 一 系列 函数 设置 绘图 对 象 的 各 个 属性 : 


plt.xlabel("Time(s)") 
plt.ylabel("Volt") 
plt.title("PyPlot First Example") 
plt.ylim(-1.2,1.2) 

plt.legend( ) 


e xlabel : 设置 X 轴 的 文字 
e ylabel : 设置 Y 轴 的 文字 
。 title: 设置 图 表 的 标题 
。 ylim : 设置 Y 轴 的 范围 
e legend: 显示 图 示 


最 后 调用 plt.show() 显 示 出 我 们 创建 的 所 有 绘图 对 象 。 


配置 属性 


matplotlib 所 绘制 的 图 的 每 个 组 成 部 分 都 对 应 有 一 个 对 象 ， 我 们 可 以 通过 调用 这 些 对 
象 的 属性 设置 方法 set_* 或 者 pyplot 的 属性 设置 函数 setp 设 置 其 属性 值 。 例 如 plot 函 

数 返 回 一 个 matplotlib.lines.Line2D 对 象 的 列表 ， 下 面 的 例子 显示 如 何 设 置 Line2D 
对 象 的 属性 : 


import numpy as np 

import matplotlib.pyplot as plt 

x = np.arange(0, 5, 0.1) 

line, = plt.plot(x, x*x) # plot 返 回 一 个 列表 ， 通 过 line, 获取 其 第 一 个 元 
# 调用 Line2D 对 象 的 Set_* 方 法 设置 属性 值 

line.set_antialiased(False) 








# 同时 绘制 sin 和 cos 两 条 曲线 ，Lines 是 一 个 有 两 个 Line2D 对 象 的 列表 
lines = plt.plot(x, np.sin(x), x, np.cos(x)) # 

# jAAsetpWRAN Bes TLine2Dt RNS NBM 
plt.setp(lines, color="r", linewidth=2.0) 


这 段 例子 中 ， 通 过 调用 Line2D 对 象 line 的 set_antialiased 方 法 ， 关 闭 对 象 的 反 锯齿 效 
果 。 或 者 通过 调用 plt.setp 函 数 配置 多 个 Line2D 对 象 的 颜色 和 线 宽 属性 。 


同样 我 们 可 以 通过 调用 Line2D 对 象 的 get * 方 法 ， 或 者 plt.getp 函 数 获取 对 象 的 属性 
值 : 


>>> 


line. get_linewidth() 
plt.getp(lines[0], "color") # 返回 color 属 性 


plt.getp(lines[1]) # 输出 全 部 属性 


alpha = 1.0 

animated = False 

antialiased or aa = True 

axes = Axes(0.125,0.1;0.775x0.8) 


定 


注意 getp 函 数 只 能 对 一 个 对 象 进行 操作 ， 它 有 两 种 用 法 : 
属 


。 指 


aN 
性 名 : 返回 对 象 的 指定 属性 的 值 


。 不 指定 属性 名 : 打印 出 对 象 的 所 有 属性 和 其 值 


matplotlib 的 整个 图 表 为 一 个 Figure 对 象 ， 此 对 象 在 调用 plt.figure 函 数 时 返回 ， 我 们 
也 可 以 通过 plt.gcf 函 数 获取 当前 的 绘图 对 象 : 


>>> f = plt.gcf() 
>>> plt.getp(f) 
alpha = 1.0 
animated = False 


Figure 对 象 有 一 个 axes 属 性 ， 其 值 为 AxesSubplot 对 象 的 列表 ， 每 个 AxesSubplot 对 
象 代表 图 表 中 的 一 个 子 图 ， 前 面 所 绘制 的 图 表 只 包含 一 个 子 图 ， 当 前 子 图 也 可 以 通 
过 plt.gca 获 得 : 


>>> plt.getp(f, "axes") 
[<matplotlib.axes.AxesSubplot object at Ox05CDD170>] 
>>> plt.gca() 

<matplotlib.axes.AxesSubplot object at Ox05CDD170> 


用 plt.getp 可 以 发 现 AxesSubplot 对 象 有 很 多 属性 ， 例 如 它 的 lines 属 性 为 此 子 图 所 包 
括 的 Line2D 对 象 列表 : 


>>> alllines = plt.getp(plt.gca(), "lines") 

>>> alllines 

<a list of 3 Line2D objects> 

>>> alllines[0] == line # 其 中 的 第 一 条 曲线 就 是 最 开始 绘制 的 那 条 曲线 
True 


通过 这 种 方法 我 们 可 以 很 容易 地 查看 对 象 的 属性 和 它们 之 间 的 包含 关系 ， 找 到 需要 
配置 的 属性 。 


绘制 多 轴 图 


一 个 绘图 对 象 (figure) 可 以 包含 多 个 轴 (axis)， 在 Matplotlib 中 用 轴 表 示 一 个 绘图 区 
域 ， 可 以 将 其 理解 为 子 图 。 上 面 的 第 一 个 例子 中 ， 绘 图 对 象 只 包括 一 个 轴 ， 因 此 只 
显示 了 一 个 轴 ( 子 图 )。 我 们 可 以 使 用 subplot 范 数 快速 绘制 有 多 个 轴 的 图 表 。subplot 
函数 的 调用 形式 如 下 : 


subplot(numRows, numCols, plotNum) 


subplot 将 整个 绘图 区 域 等 分 为 numRows 行 *numCols 列 个 子 区域 ， 然 后 按照 从 左 
到 右 ， 从 上 到 下 的 顺序 对 每 个 子 区 域 进 行 编号 ， 左 上 的 子 区 域 的 编号 为 1。 如 果 
numRows，numCols 和 plotNum 这 三 个 数 都 小 于 10 的 话 ， 可 以 把 它们 缩写 为 一 个 整 
数 ， 例 如 subplot(323) 和 subplot(3,2,3) 是 相同 的 。subplot 在 plotNum 指 定 的 区 域 中 
创建 一 个 轴 对 象 。 如 果 新 创建 的 轴 和 之 前 创建 的 轴 重 王 的 话 ， 之 前 的 轴 将 被 删除 。 


下 面 的 程序 创建 3 行 2 列 共 6 个 轴 ， 通 过 axisbg 参 数 给 每 个 轴 设 置 不 同 的 背景 颜色 。 
for idx, color in enumerate("rgbyck"): 


plt.subplot(320+idx+1, axisbg=color) 
pit .show( ) 
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用 subplot 函 数 将 Figure 分 为 六 个 子 图 区 域 

如 果 希 望 某 个 轴 占 据 整 个 行 或 者 列 的 话 ， 可 以 如 下 调用 subplot : 
plt.subplot(221) # 第 一 行 的 左 图 
plt.subplot(222) # 第 一 行 的 右 图 


plt.subplot(212) # 第 二 整 行 
plt.show() 
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将 Figure 分 为 三 个 子 图 区 域 


当 绘图 对 象 中 有 多 个 轴 的 时 候 ， 可 以 通过 工具 栏 中 的 Configure Subplots 按 钮 ， 交 
互 式 地 调节 轴 之 间 的 间距 和 轴 和 与 边框 之 间 的 距离 。 如 果 和 希望 在 程序 中 调节 的 话 ， 可 
以 调用 subplots_adjust 函 数 ， 它 有 left, right, bottom, top, wspace, hspace 等 几 个 关 


键 字 参数 ， 这 些 参数 的 值 都 是 0 到 1 之 间 的 小 数 ， 它 们 是 以 绘图 区 域 的 宽 高 为 1 进行 
正规 化 之 后 的 坐标 或 者 长 度 。 


配置 文件 


一 幅 图 有 许多 需要 配置 的 属性 ， 例 如 颜色 、 字 体 、 线 型 等 等 。 我 们 在 绘图 时 ， 并 没 
有 一 一 对 这 些 属 性 进行 配置 ， 许 多 都 直接 采用 了 Matplotlib 的 缺 省 配置 。Matplotlib 
将 缺 省 配置 保存 在 一 个 文件 中 ， 通 过 更 改 这 个 文件 ， 我 们 可 以 修改 这 些 属性 的 缺 省 


o 


Matplotlib 使 用 配置 文件 matplotlibrc 时 的 搜索 顺序 如 下 : 
。 当前 路 径 : 程序 的 当前 路 径 
e。 用 户 配置 路 径 : 通常 为 HOME/.matplotlib/， 可 以 通过 环境 变量 
MATPLOTLIBRC 修 改 
。 系统 配置 路 径 : 保存 在 matplotlib 的 安装 目录 下 的 mpl-data 下 


通过 下 面 的 语句 可 以 获取 用 户 配 置 路 径 : 
>>> import matplotlib 


>>> matplotlib.get_configdir() 
'C:\\Documents and Settings\\zhang\\.matplotlib' 


通过 下 面 的 语句 可 以 获得 目前 使 用 的 配置 文件 的 路 径 : 


>>> import matplotlib 
>>> matplotlib.matplotlib_fname() 
'C:\\Python26\\1lib\\site-packages\\matplotlib\\mpl-data\\matplotlil 


E 一 一 一 一 


由 于 在 当前 路 径 和 用 户 配置 路 径 中 都 没有 找到 位 置 文件 ， 因 此 最 后 使 用 的 是 系统 配 
置 路 径 下 的 配置 文件 。 如 果 你 将 matplotlibrc 复 制 一 份 到 脚本 的 当前 目录 下 : 





>>> import os 
>>> os.getcwd() 
'C:\\zhang\\doc' 


复制 配置 文件 之 后 再 运行 : 


>>> matplotlib.matplotlib_fname() 
'C:\\zhang\\doc\\matplotlibrc' 


如 果 你 用 文本 编辑 器 打开 此 配置 文件 的 话 ， 你 会 发 现 它 实 际 上 是 定义 了 一 个 字典 。 
为 了 对 众多 的 配置 进行 区 分 ， 关 键 字 可 以 用 点 分 开 。 


配置 文件 的 读 入 可 以 使 用 rc_params 函数 ， 它 返回 一 个 配置 字典 : 


>>> matplotlib.rc_params() 

{'agg.path.chunksize': 0, 
‘'axes.axisbelow': False, 
"axes.edgecolor': 'k', 
'axes.facecolor': 'w', 


在 matplotlib 模 块 载 入 的 时 候 会 调用 rc_params， 并 把 得 到 的 配置 字典 保存 到 
rcParams 变 量 中 : 


>>> matplotlib.rcParams 
{'agg.path.chunksize': 0, 
"'axes.axisbelow': False, 


ee ee 绘图 。 用 户 可 以 直接 修改 此 字典 中 的 配 
置 ， 所 做 的 改变 会 反映 到 此 后 所 绘制 的 图 中 。 例 如 下 面 的 脚本 所 绘制 的 线 将 带 有 辆 
形 的 点 标识 符 : 


>>> matplotlib.rcParams["lines.marker"] = "o" 
>>> import pylab 

>>> pylab.plot([1,2,3]) 

>>> pylab.show( ) 


为 了 方便 配置 ， 可 以 使 用 rec 函数， 下面 的 例子 同时 配置 点 标识 符 、 线 宽 和 颜色 : 


>>> matplotlib.rc("lines", marker="x", linewidth=2, color="red") 


如 果 希 望 恢 复 到 缺 省 的 配置 (matplotlib 载 入 时 从 配置 文件 读 入 的 配置 ) 的 话 ， 可 以 调 
用 rcdefaults HŽ 


>>> matplotlib.rcdefaults() 


如 果 手 工 修改 了 配置 文件 ， 和 希望 重新 从 配置 文件 载 人 最 新 的 配置 的 话 ， 可 以 调用 : 


>>> matplotlib.rcParams.update( matplotlib.rc_params() ) 


Artisti & 


matplotlib API 包 含有 三 层 


e backend_bases.FigureCanvas : 图 表 的 绘制 领域 
e backend_bases.Renderer : 知道 如 何在 FigureCanvas 上 如 何 绘图 
e artist.Artist : 知道 如 何 使 用 Renderer 在 FigureCanvas 上 绘图 


Foure anya RE = eee 的 绘图 操作 ， 例 如 使 用 wxPython 在 界面 上 
绘图 ， 或 者 使 用 PostScript 绘 制 PDF。Artist 则 处 理 所 有 的 高 层 结 构 ， 例 如 处理 图 
表 、 文字 和 曲线 等 的 绘制 和 布局 。 通 常 我 们 只 和 Artist 打 交道 ， 而 不 需要 关心 底层 的 

绘制 细节 。 


Artists 分 为 简单 类 型 和 容器 类 型 两 种 。 简 单 类 型 的 Artists 为 标准 的 绘图 元 件 ， 例 如 
Line2D、 Rectangle, Text, Axeslmage 等 等 。 而 容器 类 型 则 可 以 包含 许多 简单 类 
型 的 Artists， 使 它们 组 织 成 一 个 整体 ， 例 如 Axis、 Axes、Figure 等 。 


直接 使 用 Artists 创 建 图 表 的 标准 流程 如 下 : 


e 创建 Figure 对 象 
。 用 Figure 对 象 创建 一 个 或 者 多 个 Axes 或 者 Subplot 对 象 
。 调用 Axies 等 对 象 的 方法 创建 各 种 简单 类 型 的 Artists 


下 面 首先 调用 pyplot.figure 辅 助 函 数 创 建 Figure 对 象 ， 然 后 调用 Figure 对 象 的 
add_axes 方 法 在 其 中 创建 一 个 Axes 对 象 ，add_axes 的 参数 是 一 个 形 如 [left, bottom, 
width, height] 的 列表 ， 这 些 数 值 分 别 指定 所 创建 的 Axes 对 象 相对 于 fig 的 位 置 和 大 
小 ， 取 值 范 围 都 在 0 到 1 之 间 : 


>>> import matplotlib.pyplot as plt 
>>> fig = plt.figure() 
>>> ax = fig.add_axes([0.15, 0.1, 0.7, 0.3]) 


后 我 们 调用 ax 的 plot 方 法 绘图 ， 创 建 一 条 曲线 ， 并 且 返 回 此 曲线 对 象 (Line2D)。 


>>> line, = ax.plot([1,2,3],[1,2,1]) 

>>> ax.lines 

[<matplotlib.lines.Line2D object at 0x0637A3D0>] 
>>> line 

<matplotlib.lines.Line2D object at 0x0637A3D0> 


ax.lines 是 一 个 为 包含 ax 的 所 有 曲线 的 列表 ， 后 续 的 ax.plot 调 用 会 往 此 列表 中 添加 新 
的 曲线 。 如 果 想 删除 某 条 曲线 的 话 ， 直 接 从 此 列表 中 删除 即 可 。 


Axes 对 象 还 包括 许多 其 它 的 Artists 对 象 ， 例 如 我 们 可 以 通过 调用 set_xlabel 设 置 其 X 
轴 上 的 标题 : 


>>> ax.set_xlabel("time" ) 


如 果 我 们 查看 set_xlabel 的 源 代码 的 话 ， 会 发 现 它 是 通过 调用 下 面 的 语句 实现 的 : 


self .xaxis.set_label_text(xlabel) 


如 果 我 们 一 直 跟 踪 下 去 ， 会 发 现 Axes 的 xaxis 属 性 是 一 个 XAxis 对 象 : 


>>> ax.xaxis 
<matplotlib.axis.XAxis object at 0x06343230> 


XAxis 的 label 属 性 是 一 个 Text 对 象 : 


>>> ax.xaxis.label 
<matplotlib.text.Text object at 0x06343290> 


而 Text 对 象 的 _text 属 性 为 我 们 设置 的 值 : 


>>> ax.xaxis.label. text 
'time' 


这 些 对 象 都 是 Artists， 因 此 也 可 以 调用 它们 的 属性 获取 函数 来 获得 相应 的 属性 : 


>>> ax.xaxis.label.get_text() 
'time' 


Artist 的 属性 


图 表 中 的 每 个 元 素 都 用 一 个 matplotlib 的 Artist 对 象 表 示 ， 而 每 个 Artist 对 象 都 有 一 大 
堆 属 性 控制 其 显示 效果 。 例 如 Figure 对 象 和 Axes 对 象 都 有 patch 属 性 作为 其 背景 ， 
它 的 值 是 一 个 Rectangle 对 象 。 通 过 设置 此 它 的 一 些 属 性 可 以 修改 Figrue 图 表 的 背景 
颜色 或 者 透明 度 等 属性 ， 下 面 的 例子 将 图 表 的 背景 颜色 设置 为 绿色 : 


>>> fig = plt.figure() 

>>> fig.show() 

>>> fig.patch.set_color("g") 
>>> fig.canvas.draw() 


patch colorettifiit set_cllorNM# Tike, BEHAL EHTA RRA 
表 的 显示 上 ， 还 需要 调用 fig.canvas.draw() 函 数 示 能够 更 新 显示 。 


下 面 是 Artist 对 象 都 具有 的 一 些 属性 : 


e alpha: 透明 度 ， 值 在 0 到 1 之 间 ，0 为 完全 透明 ，1 为 完全 不 透明 
e animated : 布尔 值 ， 在 绘制 动画 效果 时 使 用 
e axes: 此 Artist 对 象 所 在 的 Axes 对 象 ， 可 能 为 None 


clip_box : xt RAV ASS HE 

clip_ on: 是 否 裁剪 

clip_path : 裁剪 的 路 径 

contains : 判断 指定 点 是 否 在 对 象 上 的 函数 
figure : 所 在 的 Figure 对 象 ， 可 能 为 None 
label : 文本 标签 

picker : 控制 Artist 对 象 选取 

transform : 控制 偏 移 旋转 

visible : 是 否 可 见 

zorder : 控制 绘图 顺序 


Artist 对 象 的 所 有 属性 都 通过 相应 的 get* 和 set 函数 进行 读 宇 ， 例 如 下 面 的 语句 将 
alpha 属 性 设置 为 当前 值 的 一 半 : 


>>> fig.set_alpha(0.5*fig.get_alpha() ) 


如 果 你 想 用 一 条 语句 设置 多 个 属性 的 话 ， 可 以 使 用 set 函 数 : 


>>> fig.set(alpha=0.5, zorder=2) 


使 用 前 面 介 绍 的 matplotlib.pyplot.getp 函数 可 以 方便 地 输出 Artist 对 象 的 所 有 属性 名 
和 值 。 


>>> plt.getp(fig.patch) 
aa = True 

alpha = 1.0 

animated = False 
antialiased or aa = True 


Figure 容 器 


现在 我 们 知道 如 何 观察 和 修改 已 知 的 某 个 Artist 对 象 的 属性 ， 接 下 来 要 解决 如 何 找到 
指定 的 Artist 对 象 。 前 面 我 们 介绍 过 Artist 对 象 有 容器 类 型 和 简单 类 型 两 种 ， 这 一 节 
让 我 们 来 详细 看 看 容器 类 型 的 内 容 。 


最 大 的 Artist 容 器 是 matplotlib.figure.Figure， 它 包括 组 成 图 表 的 所 有 元 素 。 图 表 的 
背景 是 一 个 Rectangle 对 象 ， 用 Figure.patch 属 性 表示 。 当 你 通过 调用 add_subplot 
或 者 add_axes 方 法 往 图 表 中 添加 轴 ( 子 图 时 )， 这 些 子 图 都 将 添加 到 Figure.axes 属 性 
中 ， 同 时 这 两 个 方法 也 返回 添加 进 axes 属 性 的 对 象 ， 注 意 返 回 值 的 类 型 有 所 不 同 ， 
实际 上 AxesSubplot 是 Axes 的 子 类 。 


>>> fig = plt.figure() 

>>> ax1 = fig.add_subplot(211) 

>>> ax2 = fig.add_axes([0.1, 0.1, 0.7, 0.3]) 
>>> ax 


<matplotlib.axes.AxesSubplot object at Ox056BCA90> 
>>> ax2 

<matplotlib.axes.Axes object at 0x056BC910> 

>>> fig.axes 

[<matplotlib.axes.AxesSubplot object at Ox056BCA90>, 
<matplotlib.axes.Axes object at 0x056BC910>] 


AT iF pylabhNgcea()\SHM, Figure RARA RAER, ALLRE 
议 直 接 对 Figure.axes 属 性 进行 列表 操作 ， 而 应 该 使 用 add_subplot, add_axes, 
delaxes 等 方法 进行 添加 和 删除 操作 。 但 是 使 用 for 循 环 对 axes 中 的 每 个 元 素 进 行 操 
作 是 没有 问题 的 ， 下 面 的 语句 打开 所 有 子 图 的 栅 格 。 


>>> for ax in fig.axes: ax.grid(True) 


Figure 对 象 可 以 拥有 自己 的 文字 、 线 条 以 及 图 像 等 简单 类 型 的 Artist。 缺 省 的 坐标 系 
统 为 像素 点 ， 但 是 可 以 通过 设置 Artist 对 象 的 transform 属 性 修改 坐标 系 的 转换 方 
式 。 最 常用 的 Figure 对 象 的 坐标 系 是 以 左下 角 为 坐标 原点 (0,0)， 右 上 角 为 坐标 
(1,1)。 下 面 的 程序 创建 并 添加 两 条 直线 到 fig 中 : 


>>> from matplotlib.lines import Line2D 

>>> fig = plt.figure() 

>>> line1 = Line2D([0,1],[0,1], transform=fig.transFigure, figure=1 
>>> line2 = Line2D([0,1],[1,0], transform=fig.transFigure, figure=1 
>>> fig.lines.extend([line1, line2]) 

>>> fig.show() 


EO ESET 





在 Figure 对 象 中 手工 绘制 直线 


注意 为 了 让 所 创建 的 Line2D 对 象 使 用 fig 的 坐标 ， 我 们 将 fig.TransFigure 赋 给 Line2D 
对 象 的 transform 属 性 ; 为 了 让 Line2D 对 象 知道 它 是 在 fig 对 象 中 ， 我 们 还 设置 其 
figure 属 性 为 fig ; 最 后 还 需要 将 创建 的 两 个 Line2D 对 象 添加 到 fig.lines 属 性 中 去 。 


Figure 对 象 有 如 下 属性 包含 其 它 的 Artist 对 象 : 


axes : Axes 对 象 列表 

patch : 作为 背景 的 Rectangle 对 象 

images : Figurelmage 对 象 列表 ， 用 来 显示 图 片 
legends : Legend 对 象 列 表 

lines : Line2D 对 象 列表 

patches : patch 对 象 列表 

texts : Text 对 象 列 表 ， 用 来 显示 文字 


Axes 容 器 


Axes 容 器 是 整个 matplotlib 库 的 核心 ， 它 包含 了 组 成 图 表 的 众多 Artist 对 象 ， 并 且 有 
许多 方法 函数 帮助 我 们 创建 、 修 改 这 些 对 象 。 和 Figure 一 样 ， 它 有 一 个 patch 属 性 作 
为 背景 ， 当 它 是 笛 卡 尔 坐 标 时 ，patch 属 性 是 一 个 Rectangle 对 象 ， 而 当 它 是 极 坐标 
时 ，patch 属 性 则 是 Circle 对 象 。 例 如 下 面 的 语句 设置 Axes 对 象 的 背景 颜色 为 绿色 : 


>>> fig = plt.figure() 
>>> ax = fig.add_subplot(111) 
>>> ax.patch.set_facecolor("green" ) 


当 你 调用 Axes 的 绘图 方法 〈 例 如 plot) ， 它 将 创建 一 组 Line2D 对 象 ， 并 将 所 有 的 关 
键 字 参数 传递 给 这 些 Line2D 对 象 ， 并 将 它们 添加 进 Axes.lines 属 性 中 ， 最 后 返回 所 
创建 的 Line2D 对 象 列表 : 


>>> X, Y = np.random.rand(2, 100) 

>>> line, = ax.plot(x, y, "-", color="blue", linewidth=2) 
>>> line 

<matplotlib.lines.Line2D object at 0x03007030> 

>>> ax.lines 

[<matplotlib.lines.Line2D object at 0x03007030>] 


注意 plot 返 回 的 是 一 个 Line2D 对 象 的 列表 ， 因 为 我 们 可 以 传递 多 组 X,Y 轴 的 数据 ， 一 
次 绘制 多 条 曲线 。 


与 plot 方 法 类 似 ， 绘 制 直方 图 的 方法 bar 和 绘制 柱状 统计 图 的 方法 hist 将 创建 一 个 
Patch 对 象 的 列表 ， 每 个 元 素 实 际 上 都 是 Patch 的 子 类 Rectangle， 并 且 将 所 创建 的 
Patch 对 象 都 添加 进 Axes.patches 属 性 中 : 


FA Python 做 科学 计算 


>>> ax = fig.add_subplot(111) 

>>> n, bins, rects = ax.hist(np.random.randn(1000), 50, facecolor=' 
>>> rects 

<a list of 50 Patch objects> 

>>> rects[0] 

<matplotlib.patches.Rectangle object at 0x05BC2350> 

>>> ax.patches[0] 

<matplotlib.patches.Rectangle object at 0x05BC2350> 


一 般 我 们 不 会 直接 对 Axes.lines 或 者 Axes.patches 属 性 进行 操作 ， 而 是 调用 add_line 
或 者 add_patch 等 方法 ， 这 些 方 法 帮助 我 们 完成 许多 属性 设置 工作 : 





&gt;&gt;&gt; fig = plt.figure() 
&gt;&gt;&gt; ax = fig.add_subplot(111) 
&gt;&gt;&gt; rect = matplotlib.patches.Rectangle((1,1), width=5 
&gt;&gt;&gt; print rect.get_axes() # rect 的 axes 属 性 为 空 
None 
&agt;&gt;&gt; rect.get_transform() # rect 的 transform 属 性 为 缺 省 值 
BboxTransformTo(Bbox(array([[ 1., a 

[ 6., 13.]]))) 
&gt;&gt;&gt; ax.add_patch(rect) # 将 rect 添 加 进 ax 
&lt;matplotlib.patches.Rectangle object at 0Xx05C34E50&gt ; 
&agt;&gt;&gt; rect.get_axes() # 于 是 rect 的 axes 属 性 就 是 ax 
&lt;matplotlib.axes.AxesSubplot object at OxO05CO9CBO&gt ; 


a] = Be 





&gt;&gt;agt; # rect 的 transform 属 性 和 ax 的 transData 相 同 
&gt;&gt;&gt; rect.get_transform( ) 

. # AK, Bie 
&gt;&gt;&gt; ax.transData 

.. # AK, BB 


&gt;&gt;&gt; ax.get_xlim() # ax 的 X 轴 范围 为 9 到 1， 无 法 显示 完整 的 rect 
Oo To 

&gt;&gt;&gt; ax.dataLim._get_bounds() # 数据 的 范围 和 rect 的 大 小 一 致 
Go aie) Sele 600) 

&gt;&gt;&gt; ax.autoscale_view() # 自动 调整 坐标 轴 范 围 
&gt;&gt;&gt; ax.get_xlim() # 于 是 X 轴 可 以 完整 显示 rect 

(10 6.0) 

&gt;&gt;&gt; plt.show() 


二 | 


通过 上 面 的 例子 我 们 可 以 看 出 ，add_patch 方 法 帮助 我 们 设置 了 rect 的 axes 和 
transform 属 性 。 
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下 面 详 细 列 出 Axes 包 含 各 种 Artist 对 象 的 属性 : 


artists : Artist 对 象 列表 

patch : 作为 Axes 背 景 的 Patch 对 象 ， 可 以 是 Rectangle 或 者 Circle 
collections : Collections RIIA 

images : AxeslImage 对 象 列表 

legends : Legend 对 象 列表 

lines : Line2D 对 象 列表 

patches : Patch 对 象 列表 

texts : Text 对 象 列表 

xaxis : XAxis 对 象 

yaxis : YAxis 对 象 


下 面 列 出 Axes 的 创建 Artist 对 象 的 方法 : 


Axes 的 方法 所 创建 的 对 象 添加 进 的 列表 
annotate Annotate texts 
bars Rectangle patches 
errorbar Line2D, Rectangle lines,patches 
fill Polygon patches 
hist Rectangle patches 
imshow Axeslmage images 
legend Legend legends 
plot Line2D lines 
scatter PolygonCollection Collections 
text Text texts 


下 面 以 绘制 散 列 图 (scatter) 为 例 ， 验 证 一 下 : 


>>> fig = plt.figure() 

>>> ax = fig.add_subplot(111) 

>>> t = ax.scatter(np.random.rand(20), np.random.rand(20) ) 

>>> t # 返回 值 为 CircleCollection 对 象 
<matplotlib.collections.CircleCollection object at 0x06004230> 
>>> ax.collections # 返回 的 对 象 已 经 添加 进 了 collections 列 表 中 
[<matplotlib.collections.CircleCollection object at 0x06004230> |] 
>>> fig.show() 

>>> t.get_sizes() # 获得 Collection 的 点 数 

20 


用 scatter 函 数 绘制 散 列 图 
Axis 容 器 


Axis 容器 包括 坐标 轴 上 的 刻度 线 、 刻 度 文 本 、 坐 标 网 格 以 及 坐标 轴 标 题 等 内 容 。 刻 
度 包括 主 刻度 和 副 刻 度 ， 分 别 通过 Axis.get_major ticks 和 Axis.get_minor ticks 方 法 
获得 。 每 个 刻度 线 都 是 一 个 XTick 或 者 YTick 对 象 ， 它 包括 实际 的 刻度 线 和 刻度 文 
本 。 为 了 方便 访问 刻度 线 和 文本 ，Axis 对 象 提 供 了 get ticklabels 和 get ticklines 方 
法 分 别 直接 获得 刻度 线 和 刻度 文本 : 


&gt;&gt;&gt; pl.plot([1,2,3],[4,5,6]) 
[&lt;matplotlib.lines.Line2D object at OxOAD3B670&gt; ] 
&gt;&gt;&gt; pl.show() 

&gt;&gt;&gt; axis = pl.gca().xaxis 


>>> axis.get_ticklocs() # 获得 刻度 的 位 置 列表 
aay OPRAS A S ON 


>>> axis.get_ticklabels() # 获得 刻度 标签 列表 

<a list of 5 Text major ticklabel objects> 

>>> [x.get_text() for x in axis.get_ticklabels()] # R®BYIENWMALFRF 
Ue Ore Us Sy Wo oy [ea 


了 — y} 





>>> axis.get_ticklines() # 获得 主 刻 度 线 列表 ， 图 的 上 下 刻度 线 共 10 条 
<a list of 10 Line2D ticklines objects> 


>>> axis.get_ticklines(minor=True) # 获得 副 刻度 线 列表 
<a list of 0 Line2D ticklines objects> 


获得 刻度 线 或 者 刻度 标签 之 后 ， 可 以 设置 其 各 种 属性 ， 下 面 设置 刻度 线 为 绿色 粗 
线 ， 文 本 为 红色 并 且 旋 转 45 度 : 


oe &gt;&gt; for label in axis.get_ticklabels(): 
: label.set_color("red") 
label.set_rotation(45) 
label.set_fontsize(1i6) 


aoe &gt;&gt; for line in axis.get_ticklines(): 
line.set_color("green") 
line.set_markersize(25) 
line.set_markeredgewidth(3) 


最 终 的 结果 图 如 下 : 


© % © 4 © 
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手工 配置 X 轴 的 刻度 线 和 刻度 文本 的 样式 


上 面 的 例子 中 ， 获 得 的 副 刻 度 线 列表 为 空 ， 这 是 因为 用 于 计算 副 刻度 的 对 象 缺 省 为 
NullLocator， 它 不 产生 任何 刻度 线 ; 而 计算 主 刻度 的 对 象 为 AutoLocator， 它 会 根 
据 当前 的 缩放 等 配置 自动 计算 刻度 的 位 置 : 


>>> axis.get_minor_locator() # 计算 副 刻 度 的 对 象 
<matplotlib.ticker.NullLocator instance at 0x0A014300> 
>>> axis.get_major_locator() # 计算 主 刻度 的 对 象 
<matplotlib.ticker.AutoLocator instance at 0x09281B20> 


我 们 可 以 使 用 程序 为 Axis 对 象 设 置 不 同 的 Locator 对 象 ， 用 来 手工 设置 刻度 的 位 置 ; 
设置 Formatter 对 象 用 来 控制 刻度 文本 的 显示 。 下 面 的 程序 设置 X 轴 的 主 刻 度 为 
pi/4， 副 刻度 为 pi/20， 并 且 主 刻度 上 的 文本 以 pi 为 单位 : 


# -*- coding: utf-8 -*- 

import matplotlib.pyplot as pl 

from matplotlib.ticker import MultipleLocator, FuncFormatter 
import numpy as np 

x = np.arange(0, 4*np.pi, 0.01) 

y = np.sin(x) 

pl.figure(figsize=(8,4)) 

pl.plot(x, y) 

ax = pl.gca() 


def pi_formatter(x, pos): 


Chae F RI a ee H LApi/4y% BAI A 


m = np.round(x / (np.pi/4)) 
fet 
if m%2==0: m, n = m/2, n/2 
if m%2==0: m, n = m/2, n/2 
if m == 0: 

return "0" 
if m == 1 and n == 

return "$\pi$" 
if n == 1: 

return r"$%d \pi$" % m 
if m == 1: 


return r"$\frac{\pi}{%d}$" % n 
return r"$\frac{%d \pi}{%d}$" % (m,n) 


# 设置 两 个 坐标 轴 的 范围 
pl.ylim(-1.5,1.5) 
pl.xlim(0, np.max(x)) 


# 设置 图 的 底 边 距 
pl.subplots_adjust(bottom = 0.15) 


pl.grid() # 开 启 网 格 


# 主 刻度 为 pi/4 
ax.xaxis.set_major_locator( MultipleLocator(np.pi/4) ) 


# EXIEMARMpi formatterHRMits 
ax.xaxis.set_major_formatter( FuncFormatter( pi_formatter ) ) 


# BIXIE Api/20 
ax.xaxis.set_minor_locator( MultipleLocator(np.pi/20) ) 


# 设置 刻度 文本 的 大 小 

for tick in ax.xaxis.get_major_ticks(): 
tick. label1.set_fontsize(16) 

pl.show( ) 


关于 刻度 的 定位 和 文本 格式 的 东西 都 在 matplotlib.ticker 中 定义 ， 程 序 中 使 用 到 如 下 


两 个 类 : 


e MultipleLocator : 以 指定 值 的 整数 倍 为 刻度 放置 刻度 线 

e FuncFormatter : 使 用 指定 的 函数 计算 刻度 文本 ， 他 会 传递 给 所 指定 的 函数 两 
个 参数 : 刻度 值 和 刻度 序号 ， 程 序 中 通过 比较 笨 的 办 法 计算 出 刻度 值 所 对 应 的 
刻度 文本 


此 外 还 有 很 多 预定 义 的 Locator 和 Formatter 类 ， 详 细 内 容 请 参考 相应 的 API 文 档 。 
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手工 配置 X 轴 的 刻度 线 的 位 置 和 文本 ， 并 开启 副 刻度 


Traits- 为 Python 添加 类 型 定义 


Python 作为 一 种 动态 编程 语言 ， 它 的 变量 没有 类 型 ， 这 种 灵活 性 给 快速 开发 带 来 很 
多 便利 ， 不 过 它 也 不 是 没有 缺点 。Traits 库 的 一 个 很 重要 的 目的 就 是 为 了 解决 这 些 
缺点 所 带 来 的 问题 。 
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Traits 库 最 初 是 为 了 开发 Chaco( 一 个 2D 绘 图 库 ) 而 设计 的 ， 绘 图 库 中 有 很 多 绘图 用 的 
对 象 ， 每 个 对 象 都 有 很 多 例如 线 型 、 颜 色 、 字 体 之 类 的 属性 。 为 了 方便 用 户 使 用 ， 
每 个 属性 可 以 允许 多 种 形式 的 值 。 例 如 ， 颜 色 属 性 可 以 是 


e 'red' 
e Oxff0000 
e (255, 0, 0) 


也 就 是 说 可 以 用 字符 串 、 整 数 、 组 元 等 类 型 的 值 表 达 颜 色 ， 这 样 的 需求 初 看 起 来 用 
Python 的 无 类 型 变量 是 一 个 很 好 的 选择 ， 因 为 我 们 可 以 把 各 种 各 祥 的 值 赋值 给 颜色 
属性 。 但 是 颜色 属性 虽然 可 以 接受 多 样 的 值 ， 却 不 是 能 接受 所 有 的 值 ， 比 如 "abc"、 

0.5 等 等 就 不 能 很 好 地 表示 颜色 。 而 且 虽 然 为 了 方便 用 户 使 用 ， 对 外 的 接口 可 以 接受 
各 种 各 样 形式 的 值 ， 但 是 在 内 部 必须 有 一 个 统一 的 表达 方式 来 简化 程序 的 实现 。 


用 Trait 属 性 可 以 很 好 地 解决 这 样 的 问题 : 


e。 它 可 以 接受 能 表示 颜色 的 各 种 类 型 的 值 

eo 当 给 它 赋值 为 不 能 表达 颜色 的 值 时 ， 它 能 够 立即 捕捉 到 错误 ， 并 且 提 供 一 个 有 
用 的 错误 报告 ， 告 诉 用 户 它 能 够 接受 什么 样 的 值 

e 它 提 供 一 个 内 部 的 标准 的 颜色 表达 方式 


让 我 们 来 看 一 下 使 用 traits 属 性 表示 颜色 的 例子 : 


from enthought.traits.api import HasTraits, Color 


class Circle(HasTraits): 
color = Color 


这 个 程序 从 enthought.traits.api 中 导入 我 们 需要 使 用 的 两 个 对 象 : HasTraits 和 

Color。 所 有 拥有 trait 属 性 的 类 都 需要 从 HasTraits 继 承 。 由 于 Python 的 多 继承 特 
性 ， 我 们 很 容易 将 现 有 的 类 改 为 支持 trait 属 性 。Color 是 一 个 TraitFactory 对 象 ， 我 们 
在 Circle 类 的 定义 中 用 它 来 声明 一 个 color 属 性 。 


熟悉 Python 的 朋友 可 能 会 对 这 个 程序 觉得 有 些 奇 怪 : 按照 标准 的 Python 语法 ， 直 接 
在 class 下 定义 的 属性 color 应 该 是 属于 Circle 类 的 属性 。 而 我 们 这 里 是 希望 给 Circle 
类 的 实例 一 个 color 属 性 ， 是 不 是 应 该 在 初始 化 画 数 ”init ”中 运行 color = Color 呢 ? 


答案 是 否定 的 ， 请 记 住 trait 属 性 像 类 的 属性 一 样 定义 ， 像 实例 的 属性 一 样 使 用 ， 我 
们 不 管 HasTraits 是 如 何 实 现 这 一 点 的 ， 先 来 看 看 如 何 使 用 trait 属 性 : 


>>> c = Circle() 

>>> Circle.color 

Traceback (most recent call last): 

AttributeError: type object 'Circle' has no attribute '‘'color' 
>>> c.color 

wx. Colour(255, 255, 255, 255) 


我 们 看 到 Circle 类 没有 color 属 性 ， 而 它 的 实例 c 则 有 一 个 color 属 性 ， 其 缺 省 值 为 
wx.Colour(255, 255, 255, 255), 


>>> c.color = "red" 
>>> c.color 
wx.Colour(255, ©, ©, 255) 
>>> c.color = Ox00ff00 
>>> c.color 
wx.Colour(@, 255, ©, 255) 
>>> ¢€.color = (0, 255, 255) 
>>> c.color 
wx.Colour(@, 255, 255, 255) 
>>> c.color = 0.5 
Traceback (most recent call last): 
File "c:\python25\lib\site-packages\Traits-3.1.0-py2.5-win32.egg' 
traits\trait_handlers.py", line 175, in error value ) 
TraitError: The 'color' trait of a Circle instance must be a string 
(r,g,b) or (r,g,b,a) where r, g, b, and a are integers from © to 2! 
instance, an integer which in hex is of the form OxRRGGBB, where RI 
green, and BB is blue or 'aquamarine' or 'black' or 'blue violet' « 
'brown' or ‘cadet blue' or 'coral' or 'cornflower blue' or 'cyan' ( 
多 英文 颜色 名 ... or 'yellow', but a value of 0.5 <type 'float'> was sl 


SSS 


c.color 支 持 "red"、0x00ff00 和 (0, 255, 255) 等 值 。 但 它 不 支持 0.5 这 祥 的 浮 点 数 ， 于 
是 一 个 很 详细 的 出 错 信 息 告 诉 我 们 它 所 有 能 支持 的 值 。 


在 开始 下 一 节 之 前 ， 最 后 来 看 一 个 很 酷 的 东西 : 





>>> c.configure_traits() 
True 

>>> c.color 

wx.Colour(64, 34, 117, 255) 


执行 c.configure _traits() 之 后 ， 出 现 如 下 的 对 话 框 以 供 我 们 修改 颜色 属性 ， 任 意 选择 
一 个 颜色 、 按 OK 按钮 ， 看 到 configure_traits 函 数 返 回 True， 而 c.color 已 经 变 为 我 们 
所 选择 的 颜色 了 。 注 意 你 需要 在 iPython -wthread 或 者 spyder 下 运行 此 函数 ， 否 则 
会 出 现 对 话 框 不 响应 的 问题 。 








自动 生成 的 修改 颜色 Trait 属 性 的 对 话 框 


Traits 是 什么 


trait 为 Python 对 象 的 属性 增加 了 类 型 定义 的 功能 ， 此 外 还 提供 了 如 下 的 额外 功能 : 


。 初始 化 : 每 个 trait 属 性 都 定义 有 自己 的 缺 省 值 ， 这 个 缺 省 值 用 来 初始 化 属性 

° — : 基于 trait 的 属性 都 有 明确 的 类 型 定义 ， 只 有 满足 定义 的 值 才 能 赋值 给 属 

e 委托 : trait 属 性 的 值 可 以 委托 给 其 他 对 象 的 属性 

e 监听 : trait 属 性 的 值 的 改变 可 以 触发 指定 的 函数 的 运行 

° a : 拥有 trait 属 性 的 对 象 可 以 很 方便 地 提供 一 个 用 户 界面 交互 式 地 改变 trait 
属性 的 值 


下 面 这 个 简单 的 例子 展示 了 trait 所 提供 的 这 五 项 能 力 : 


from enthought.traits.api import Delegate, HasTraits, Instance, Ini 


class Parent ( HasTraits ): 
# 初始 化 : Last_name 被 初始 化 为 "Zhang 
last_name = Str( 'Zhang' ) 


class Child ( HasTraits ): 
age = Int 


# 验证 ; father 属 性 的 值 必 须 是 Parent 类 的 实例 
father = Instance( Parent ) 


# 委托 : Child 的 实例 的 last_name 属 性 委托 给 其 father 属 性 的 last_name 
last_name = Delegate( 'father' ) 


# 监听 : 当 age 属 性 的 值 被 修改 时 ， 下 面 的 范 数 将 被 运行 
def age changed ( self, old, new ): 
print 'Age changed from %s to %s ' % ( old, new ) 


B E 
下 面 用 这 两 个 类 创建 立 两 个 实例 : 





>>> p 
>>> C 


Parent() 
Child() 


由 于 没有 设置 c 的 father 属 性 ， 因 此 无 法 获得 它 的 last_name 属 性 : 


>>> c.last_name 
Traceback (most recent call last): 
AttributeError: 'NoneType' object has no attribute 'last_name' 


设置 father 属 性 之 后 ， 我 们 就 可 以 得 到 c 的 last_ name 了: 


>>> c.father = p 
>>> c.last_name 
"Zhang' 


设置 c 的 age 属性 将 触发 age_changed 方 法 的 执行 : 


>>> C.age = 4 
Age changed from © to 4 


调用 configure_traits: 


>>> c.configure_traits() 
True 


弹出 一 个 如 下 的 对 话 框 ， 用 户 可 以 通过 它 修改 c 的 trait 属 性 ， 
% Edit properties -| 口 | x 






Last name: | Zhang 








为 Child 类 自动 生成 的 属性 修改 对 话 框 


可 以 看 到 属性 按照 其 英文 名 排序 ， 垂 直 排 为 一 列 。 由 于 father 属 性 是 Parent 类 的 实 
例 ， 所 以 它 给 我 们 一 个 按钮 ， 点 此 按钮 出 现下 面 的 设置 father 对 象 的 tratis 属 性 的 对 
话 框 





% Edit properties -Iof x} 


Last name: [AE 
OK | Cancel | 


点 击 Child 对 话 框 中 的 Father 按 钮 之 后 ， 弹 出 编辑 father 属 性 的 对 话 框 


在 上 面 这 个 对 话 框 中 修改 father 的 Last name， 可 以 看 到 child 的 Last name 属 性 也 随 
之 发 生变 化 。 





我 们 可 以 调用 print traits 方 法 输出 所 有 的 trait 属 性 与 其 值 : 


>>> c.print_traits() 


age: 4 
father: <__main__.Parent object at 0x13B49120> 
last_name: u'Zhang' 


调用 get 方 法 获得 一 个 描述 对 象 所 有 trait 属 性 的 dict: 


>>> c.get() 
{'age': 4, 'last_name': u'Zhang', 'father': <__main__.Parent object 


4 a 
此 外 还 可 以 调用 set 方 法 设置 trait 属 性 的 值 ，set 方 法 可 以 同时 配置 多 个 trait 的 属性 : 





>>> c.set(age = 6) 
Age changed from 4 to 6 
<__main__.Child object at 0x13B494B0> 


动态 添加 Trait 属 性 


前 面 介 绍 的 方法 都 是 在 类 的 定义 中 声明 Trait 属 性 ， 在 类 的 实例 中 使 用 Trait 属 性 。 由 
于 Python 是 动态 语言 ， 因此 Traits 库 也 提供 了 为 某 个 特定 的 实例 添加 Trait 属 性 的 方 


法 。 


下 面 的 例子 ， 直 接 产生 HasTraits 类 的 一 个 实例 a, 然后 调用 其 add_trait 方 法 动态 地 为 
a 添 加 一 个 名 为 x 的 Trait 属 性 ， 其 类 型 为 Float， 初 始 值 为 3.0。 


>>> from enthought.traits.api import * 
>>> a = HasTraits() 

>>> a.add_trait("x", Float(3.0)) 

>>> a.X 

3.0 


接 下 来 再 创建 一 个 HasTraits 类 的 实例 b， 用 add _trait 方 法 为 b 添 加 一 个 属性 a， 指 定 
其 类 型 为 HasTraits 类 的 实例 。 然 后 把 实例 a 赋值 给 实例 b 的 属性 a : b.a。 


>>> b = HasTraits() 
>>> b.add_trait("a", Instance(HasTraits)) 
>>> b.a=a 


然后 为 实例 b 添 加 一 个 类 型 为 Delegate( 代 理 ) 的 属性 y， 它 是 b 的 属性 a 所 表示 的 实例 
的 属性 x 的 代理 ， 即 b.y 是 b.a.x 的 代理 。 注 意 我 们 在 用 Delegate 声 明代 理 时 ， 第 一 个 
参数 b 的 一 个 属性 名 "a"， 第 二 个 参数 是 是 此 属性 的 属性 名 "x"，modify=True 表 示 可 
以 通过 b.y 修 改 b.a.x 的 值 。 我 们 看 到 当 将 b.y 的 值 改 为 10 的 时 候 ，a.x 的 值 也 同时 改变 
了 。 


>>> b.add_trait("y", Delegate("a", "x", modify=True) ) 


Property 属 性 


标准 的 Python 提供 了 Property 功 能 ，Property 看 起 来 像 对 象 的 一 个 成 员 变 量 ， 但 是 
在 获取 它 的 值 或 者 给 它 赋 值 的 时 候 实 际 上 是 调用 了 相应 的 函数 。Traits 也 提供 了 类 
似 的 功能 。 让 我 们 先 来 看 一 个 例子 : 


# -*- coding: utf-8 -*- 
# filename: traits_property.py 
from enthought.traits.api import HasTraits, Float, Property, cachet 


class Rectangle(HasTraits): 
width = Float(1.0) 
height = Float(2.0) 


#area 是 一 个 属性 ， 当 width, height ibit, Taah _get_area RU ig 
area = Property(depends_on=['width', 'height']) 


# 通过 cached_property decorator tz_get_areakižtijž H 
@cached_property 
def _get_area(self): 


areafget WA, FmILNHMAA st mAProertyANXKR 


print 'recalculating' 
return self.width * self.height 


E — z 


在 Rectangle 类 定义 中 ， 使 用 Property() 定 义 了 一 个 area 属 性 。Traits 所 提供 的 
Property 和 标准 Python 的 有 所 不 同 ，Traits 中 根据 属性 名 直接 决定 了 它 的 访问 画 数 ， 
当 用 户 读 取 area 值 时 ， 将 得 到 _get_area 加 数 的 返回 值 ; 而 设置 area 的 值 时 ， 
_Set_area 函 数 将 被 调用 。 此 外 ， 通 过 关键 字 参 数 depends_on， 指 定 当 width 和 
height 属 性 变化 时 自动 计算 area 属 性 。 





_get_areai št H @cached_property 47184, (ES get_areak Zt An [ol a $ 
被 缓存 ， 除 非 width 和 height 的 值 发 生变 化 ， 否 则 将 一 直 使 用 缓存 的 值 。 下 面 我 们 来 
看 看 Rectangle 的 用 法 。 在 traits_property.py 的 文件 夹 下 ， 启 动 IPython -wthread : 


>>> run traits property.py 

>>> r = Rectangle() 

>>> r.area # <-- 第 一 次 取得 area， 需 要 进行 运算 
recalculating 

2.0 

>>> r.width = 10 

>>> r.area # <-- 修 改 width 之 后 ， 取 得 area， 需 要 进行 计算 
recalculating 

20.0 

>>> r.area # <--Width 和 height 都 没有 发 生变 化 ， 因 此 直接 返回 缓存 值 ， 没 有 重新 讨 
20.0 


我 们 看 到 通过 depends_on 和 人 @cached_property， 系 统 可 以 跟踪 area 属 性 的 状态 ， 
判断 是 否 需要 调用 _get_area 函 数 重新 计算 area 的 值 。 注 意 在 运行 r.width=10 时 ， 并 
没有 立即 运行 _get_area 豆 数 ， 这 是 因为 系统 知道 没有 任何 物体 在 监听 r.area 属 性 ， 
因此 它 只 是 保存 一 个 需要 重新 计算 的 标志 。 等 到 真正 需要 获取 area 的 值 时 ， 再 调用 
_get_area 了 辑 数 。 


如 果 我 们 调用 r.edit_traits()， 就 会 看 到 depends_on 的 强大 功能 了 。 为 了 更 加 有 趣 一 
些 ， 这 里 连续 调用 两 次 edit_traits， 弹 出 两 个 编辑 界面 : 


>>> r.edit_traits() 
<enthought.traits.ui.ui.UI object at Ox02FCD420> 
>>> r.edit_traits() 
<enthought.traits.ui.ui.UI object at Ox02FD68A0> 













thon 


3° J 


= Edi -ioj x| 


r.edit_traits() Area: [699.0 
<enthought.traits Height: [23.3 


jidth: [30.0 
r.edit traits() 人 


<enthought.traits OK | Cancel | 


recalculating $s Edit properties olx 
recalculating Area: [699.0 
recalculating Height: [23.3 


recalculating 


recalculating Width: [30.0 | 
recalculating OK | a | 











修改 两 个 对 话 框 中 的 任意 个 Height 或 者 Width 属 性 都 会 重新 计算 Area， 并 同时 更 新 
对 话 框 显示 


然后 修改 任何 一 个 界面 中 的 width 或 者 height 属 性 ， 你 可 以 注意 到 在 输入 数值 的 同 
时 ， 两 个 界面 中 的 Area，Height 和 Width 等 各 个 文本 框 同时 更 新 ， 每 次 键盘 按键 都 
会 调用 _get_area 琅 数 。 此 时 在 IPython 窗 口 修改 width 的 值 的 话 ， 也 会 调用 
_get_areaky a : 


>>> r.width = 25 
recalculating 


当 打 开 界 面 之 后 ， 界 面 对 象 开始 监听 对 象 r 的 各 个 属性 ， 因 此 当 我 们 修改 rwidth 之 
i 系统 设置 rarea 的 标志 为 需要 重新 计算 ， td aR 
e eae # 值 ， 并 上 且 通知 所 有 的 监听 对 象 ， 因 此 界面 就 一 
更 新 了 。 


让 我 们 来 看 看 在 traits 的 内 部 ， 是 如 何 处 理 属性 值 的 改变 引起 界面 变化 的 : 


# -*- coding: utf-8 -*- 
# filename: traits_listener.py 
from enthought.traits.api import * 


class Child ( HasTraits ): 
name = Str 
age = Int 
doing = Str 


def _ str (self): 
return "%s<%x>" % (self.name, id(self)) 


# 通知 : 当 age 属 性 的 值 被 修改 时 ， 下 面 的 函数 将 被 运行 
def _age_changed ( self, old, new ): 
print "%s.age changed: form %s to %s" % (self, old, new) 


def _anytrait_changed(self, name, old, new): 
print "anytrait changed: %s.%s from %s to %s" % (Self, name 


def log_trait_changed(obj, name, old, new): 
print "log: %s.%s changed from %s to %s" % (obj, name, old, nev 


if _ name == "” main _ 
h = Child(name = "HaiYue", age=4) 
k = Child(name = "KaiYu", age=1) 
h.on_trait_change(log_trait_changed, name="doing" ) 


到 
Child 类 有 一 个 age 属 性 ， 当 其 值 发 生变 化 时 ， 其 对 应 的 静态 监听 画 数 


_age_changed 将 被 调用 ， 而 _anytrait changed 则 是 一 个 特殊 的 静态 监听 画 数 ， 
HasTraits 对 象 的 任何 trait 属 性 值 的 改变 都 会 调用 此 画 数 。 





log_trait_changed 是 一 个 普通 函数 。 通 过 h.on_trait_change 调 用 动态 地 将 其 与 h 的 
doing 属 性 联系 起 来 ， 即 当 h 对 象 的 doing 属 性 改变 时 ，log_trait_changed 画 数 闻 被 调 


o 


在 IPython 中 运行 上 面 的 程序 : 


>>> run traits_ listener.py 

anytrait changed: <201ba80>.age from © to 4 
<201ba80>.age changed: form © to 4 

anytrait changed: HaiYue<20iba80>.name from to HaiYue 
anytrait changed: <20ibae0>.age from © to 1 
<201bae0>.age changed: form © to 1 

anytrait changed: KaiYu<201bae0>.name from to KaiYu 


然后 分 别 改变 h 和 k 这 两 个 对 象 的 各 个 属性 : 


>>> h.age = 5 

anytrait changed: HaiYue<5d87e70>.age from 4 to 5 
HaiYue<5d87e70>.age changed: form 4 to 5 

>>> h.doing = "sleeping" 

anytrait changed: HaiYue<5d87e70>.doing from to sleeping 
log: HaiYue<5d87e70>.doing changed from to sleeping 

>>> k.doing = "playing" 

anytrait changed: KaiYu<5d874e0>.doing from to playing 





centra 监听 函数 按照 顺序 被 调用 
ae 静态 监听 函数 
Trait 属 性 : age P _anytrait_changed 动态 监听 1 | 动态 监听 2 | ...... 
doing _age_changed 


Trait 属 性 的 监听 函数 的 调用 顺序 
静态 监听 画 数 的 参数 有 如 下 几 种 形式 : 


_age_changed(self) 
_age_changed(self, new) 
_age_changed(self, old, new) 
_age_changed(self, name, old, new) 


ma AS Ms OT PAYS SN ON ELAR : 


observer() 

ovserver(new) 
ovserver(name, new) 
ovserver(obj, name, new) 
ovserver(obj, name, old, new) 


其 中 obj 表 示 属 性 发 生变 化 的 对 象 ，name 为 发 生 改 变 的 属性 名 ，old 为 改变 前 的 值 ， 
new 为 现在 值 。 


动态 监听 阔 数 不 但 可 是 普通 画 数 ， 还 可 以 是 某 个 对 象 的 方法 。 
当 多 个 trait 属 性 都 需要 同一 个 静态 监听 画 数 时 ， 用 固定 函数 名 就 比较 麻烦 了 : 你 需 


要 写 多 个 _xxx_changed 画 数 ， 其 中 再 调用 某 个 函数 进行 同 桩 的 处 理 。Trait 库 提供 
的 解决 方案 是 : 用 @on trait changed 对 监听 画 数 进行 修饰 : 


TraitsUl- 轻 松 制作 用 户 界 面 


Python 有 着 丰富 的 界面 开发 库 ， 除 了 缺 省 安装 的 Tkinter 以 外 ，wxPython、pyQt4 等 
都 是 非常 优秀 的 界面 开发 库 。 但 是 它们 有 一 个 共同 的 问题 : 需要 开发 者 掌握 众多 的 
API 画 数 ， 许 多 细节 ， 例 如 配置 控件 的 属性 、 位 置 以 及 事件 响应 都 需要 开发 者 一 一 
处 理 。 


在 开发 科学 计算 程序 时 ， 我 们 希望 快速 实现 一 个 够 用 的 界面 ， 让 用 户 能 够 交互 式 的 
处 理 数据 ， 而 又 不 希望 在 界面 制作 上 花费 过 多 的 精力 。 以 traits 为 基础 、 以 Model- 
View-Controller 为 设计 思想 的 TraitUIl 库 就 是 实现 这 一 理想 的 最 佳 伴 侣 。 


缺 省 界面 


TraitsUl 是 一 套 建 立 在 Traits 库 基 础 上 的 用 户 界 面 库 。 它 和 Traits 紧密 相连 ， 如 果 你 已 
经 设计 好 了 一 个 继承 于 HasTraits 的 类 的 话 ， 那 么 直接 调用 其 configure_traits 方 法 ， 
系统 将 会 使 用 TraitsUl 自 动 生成 一 个 界面 ， 以 供用 户 交 互 式 地 修改 对 象 的 trait 属 性 。 
让 我 们 先 来 看 下 面 这 个 例子 : 


from enthought.traits.api import HasTraits, Str, Int 


class SimpleEmployee(HasTraits): 
first_name = Str 
last_name = Str 
department = Str 


employee_number = Str 
salary = Int 


sam = SimpleEmployee( ) 
sam.configure_traits() 


此 程序 创建 一 个 SimpleEmployee 类 的 对 象 Ssam， 然 后 调用 sam.configure_traits 显 示 
出 如 下 的 缺 省 界面 : 











% Edit properties 


Department: | | 
Employee number: [| 
First name: | | 
Last name: | | 

Salary: fo 


OK | Cancel | 


自动 生成 的 SimpleEmployee 类 的 对 话 框 





可 以 看 到 此 界面 是 自动 根据 trait 属 性 生成 。 所 有 的 属性 都 以 文本 框 的 形式 编辑 ， 并 
且 每 个 文本 框 前 面 都 有 一 个 文字 标签 ， 其 文字 根据 trait 属 性 名 自动 生成 : 第 一 个 字 
母 变 为 大 宇 ， 所 有 的 下 划 线 变 为 空格 。 最 下 面 为 我 们 提供 了 OK 和 Cancel 按 钮 以 确 
定 或 者 取消 对 trait 属 性 值 的 修改 。 

salary 属 性 虽然 和 其 它 属性 一 样 都 采用 文本 框 进行 编辑 ， 但 是 由 于 salary 属 性 定义 为 
Int 类 型 ， 所 以 它 将 检查 非法 输入 ， 并 以 红色 背景 警示 ， 妃 标 左 击 Salary 标 签 ， 将 弹 
出 salary 属 性 相关 的 详细 说 明 ， 由 于 我 们 没有 设置 此 说 明 ， 系 统 缺 省 给 出 salary 所 能 
接受 的 值 的 类 型 。 


se Edit propa -lolx 
Department: la o 
Employee number: | 
First name: | | 

Last name: | | 


Must be an integer. 













OK | 
界面 中 的 每 个 属性 编辑 器 都 有 详细 说 明 ， 并 且 能 检查 非法 输入 
我 们 连 一 行 界 面相 关 的 代码 都 没有 写 ， 却 能 得 到 这 样 一 个 已 经 够 实用 的 界面 ， 应 该 
还 是 很 伟人 满意 的 吧 。 为 了 人 工控 制 界 面 的 设计 和 布局 ， 就 需要 我 们 添加 自己 的 代 
码 了 。 
自 定 义 界 面 


下 面 的 程序 在 前 面 的 基础 上 自 定义 了 一 个 视图 对 象 view1， 然 后 将 此 对 象 传 递 给 
configure_traits 方 法 ， 于 是 界面 就 按照 视图 中 描述 的 那样 生成 了 : 


# -*- coding: utf-8 -*- 
from enthought.traits.api import HasTraits, Str, Int 
from enthought.traits.ui.api import View, Item 


class SimpleEmployee(HasTraits): 
first_name = Str 
last_name = Str 
department = Str 
employee_number = Str 
salary = Int 


view1 = View( 
Item(name = 'department', label=u" 部 门 "，tooltip=u" 在 哪个 部 门 干 活 ' 
Item(name = 'last_name', label=u" 姓 ")， 
Item(name = 'first_name', label=u" 名 ")) 


sam = SimpleEmployee() 
sam.configure_traits(view=view1) 








选择 后 台 界 面 库 


用 traits.ui 库 创建 的 界面 可 以 选择 后 台 界 面 库 ， 目 前 支持 的 有 qt4 和 wx 两 种 。 在 启 
程序 时 添加 -toolikt qt4 或 者 -toolikt wx 选择 使 用 何 种 界面 库 生 成 界面 。 iene 
使 用 wx 作为 后 台 界 面 库 。 


£8 Edit properti [sl E43 






SBI: | ae 
ne: 


名 : | 
通过 label 和 tooltip 手 工 指定 属 性 编辑 器 的 标签 和 说 明 


有 关 界 面 视 图 的 对 象 都 在 traits.ui 库 中 ， 所 以 首先 从 其 中 载 和 View 和 ltem。View 用 
来 生成 视图 ， 而 ltem 则 用 来 描述 视图 中 的 项 目 (控件 )。 程 序 中 ， 用 ltem 依 次 创建 三 
个 视图 项 目 ， 都 作为 参数 传递 给 View， 于 是 所 生成 的 界面 中 按照 参数 的 顺序 显示 控 
件 ， 而 不 是 按照 trait 属 性 名 排序 了 。 





ltem 对象 


ltem 对 象 是 视图 的 基本 组 成 单位 ， 每 个 ltem 描 述 界 面 中 的 中 的 一 个 控件 ， 通 常 都 是 
用 来 显示 HasTraits 对 象 中 的 某 一 个 trait 属 性 。 每 个 ltem 由 一 系列 的 关键 字 参 数 来 进 
行 配 置 ， 这 些 参数 对 ltem 的 内 容 、 表 现 以 及 行为 进行 描述 。 其 中 最 重要 的 一 个 参数 
就 是 name。 我 们 看 到 name 参 数 的 值 都 配置 为 SimpleEmployee 类 的 trait 属 性 名 ， 于 
是 Item 就 知道 到 哪里 去 寻找 真正 要 显示 的 值 了 。 可 以 看 出 视图 与 数据 是 通过 属性 名 
联系 起 来 的 。 剩 下 的 两 个 参数 label 和 tooltip 设 置 ltem 在 界面 中 的 一 些 显示 相关 的 属 


性 。ltem 对 象 还 有 很 多 属性 其 它 属 性 ， 请 参考 TraitsUI 的 用 户 手册 ， 或 者 在 iPython 
中 输入 ltem?? 直 接 查 看 其 源 代码 。 如 果 你 查看 了 ltem 的 源 代 码 的 话 ， 你 就 会 发 现 ， 
原来 ltem 的 这 些 属性 也 都 是 用 trait 定 义 的 : 


class Item ( ViewSubElement ): 
mm An element in a Traits-based user interface. 


# Trait definitions: 


# A unique identifier for the item. If not set, it defaults to 
# of **name**. 
id = Str 


# User interface label for the item in the GUI. If this attribt 
# set, the label is the value of **name** with slight modificat 
# underscores are replaced by spaces, and the first letter is ¢ 
# If an item's **name** is not specified, its label is displaye 
# static text, without any editor widget. 

label = Str 


# Name of the trait the item is editing: 
name = Str 


i 此 





除了 Item 之 外 ，TraitsUl 库 还 定义 了 下 面 几 个 ltem 的 子 类 : 


e Label 
e Heading 
e Spring 


这 些 类 用 来 协助 View 的 布局 ， 因 此 不 需要 和 某 个 trait 属 性 关联 。 


Group 对 象 


前 面 的 例子 中 ， 我 们 通过 把 三 个 tem 对 象 传递 给 View， 创 建 了 一 个 控件 垂直 排列 的 
布局 。 然 而 在 真正 的 界面 开发 中 ， 需 要 更 加 高 级 的 布局 方式 ， 例 如 ， 将 一 组 相关 的 
元 素 组 织 在 一 起 ， 放 到 一 个 组 中 ， 我 们 可 以 为 此 组 添加 标签 ， 定 义 组 的 帮助 文本 ， 
通过 设置 组 的 属性 使 组 类 的 元 素 同时 有 效 或 无 效 。 在 TraitUl 中 ， 这 样 的 组 的 功能 通 
过 Group 对 象 实现 ， 让 我 们 来 修改 一 下 前 面 的 例子 


# -*- coding: utf-8 -*- 


from enthought.traits.api import HasTraits, Str, 
from enthought.traits.ui.api import View, 


Int 


Item, Group 


class SimpleEmployee(HasTraits): 


first _name = St 
last_name = Str 
department = St 


employee_numb 
salary = Int 


er 


r 


r 


Str 


bonus = Int 
view1 = View( 
Group( 
Item(name = 'employee_number', label=u'4%5'), 
Item(name = 'department',， label=u" 部 门 "，tooltip=u" 在 哪个 部 门 
Item(name = 'last_name', label=u" 姓 ")， 
Item(name = 'first_name', label=u" 名 "), 
label = u' 个 人 信息 '， 
show_border = True 
), 
Group( 
Item(name = 'salary', label=u"T¥#"), 
Item(name = 'bonus', label=u"##"), 
label = u' 收 入 '， 
show_border = True 
) 
) 
sam = SimpleEmployee() 


sam.configure_traits(view=view1 ) 
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分 标签 页 显示 两 个 Group 的 内 容 


我 们 分 别 创建 两 个 Group 传递 给 View， 每 个 Group 中 仍然 通过 Item 创建 控件 ， 通 过 
Group 的 关键 字 参 数 指定 其 label 和 show_border 属 性。 由 于 View 中 的 所 有 内 容 都 是 
Group， 它 自动 地 将 两 个 Group 放 到 Tab 中 ， 对 两 个 Group 进行 分 标签 显示 。 


如 果 我 们 希望 能 同时 看 到 两 个 Group 的 话 ， 可 以 另外 再 创建 一 个 Group 将 这 两 个 
Group 包括 起 来 : 


view2 = View( Group( view1.content ) ) 


这 里 我 们 创建 视图 view2， 它 包括 一 个 Group， 此 Group 的 内 容 则 直接 使 用 view1 的 
内 容 (也 就 是 那 两 个 Group)。 当 然 也 可 以 把 view1 中 的 内 容 复 制 进 去 : 


view2 = View(Group( 


Group( 
Item(name = 'employee_number', label=u'4%5'), 
Item(name = 'department',， label=u" 部 门 "，tooltip=u" 在 哪个 部 门 
Item(name = 'last_name', label=u" 姓 ")， 
Item(name = 'first_name', label=u" 名 "), 


label = u' 个 人 信息 '， 
show_border = True 


); 


Group( 
Item(name = 'salary', label=u"T¥#"), 
Item(name = 'bonus', label=u"##"), 


label = u' 收 入 '， 
show_border = True 





然后 我 们 将 view2 传 递 给 configure _traits， 用 view2 显 示 界 面 : 


sam.configure_traits(view=view2 ) 
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竖 排 显示 两 个 Group 的 内 容 


在 创建 Group 时 ， 我 们 可 以 通过 设置 其 orientation 和 layout 等 属性 ， 改 变 Group 的 内 
容 呈 现 方 式 。 由 于 某 些 设置 会 经 常用 到 ， 因 此 还 提供 了 专门 的 Group 子 类 重 载 这 些 
属性 的 缺 省 值 。 例 如 下 面 是 从 Group 类 继承 的 HSplit 类 的 代码 : 


class HSplit ( Group ): 


fo ea. oho 
layout = 'split' 
orientation = 'horizontal' 


HSplit 对 象 将 其 所 包括 的 内 容 按照 水 平 排列 ， 并 且 在 每 两 个 子 内 容 之 间 添 加 一 个 可 
调整 的 分 隔 条 ，HSplit 和 如 下 的 代码 是 等 价 的 : 


Group( ... , layout = 'split', orientation = 'horizontal' ) 


为 了 正确 显示 分 隔 条 ， 其 子 内 容 中 需要 有 一 个 具有 scrollable 属 性 ， 如 下 面 的 代码 
(省 略 ltem 定 义 等 部 分 ) 所 示 : 


Group(orientation= 'horizontal' ) 


e HFlow: 内 容 水 平 排列 ， 当 超过 水 平 宽度 时 ， 将 自动 换行 : 


Group(orientation= 'horizontal', layout='split') 


o Tabbed: 内 容 分 标签 页 显示 : 


Group(orientation= 'vertical' ) 


o VFlow: 内 容 垂 直 排 列 ， 当 超过 垂直 高 度 时 ， 将 自动 换 列 : 

Group(orientation= 'vertical', layout='flow', show_labels=False 
| 

o VFold : AR#EH, Dita : 

Group(orientation= 'vertical', layout='fold', show_labels=False 
SSS SSE aS Saas 

o VGrid : 按照 两 列 的 网 格 进行 垂直 排列 : 


Group(orientation= 'vertical', columns=2) 


o VSplit : 内 容 垂直 排列 ， 中 间 插入 分 隔 条 : 


Group(orientation= 'vertical', layout='split') 
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前 面 介 绍 了 如 何 使 用 tem 和 Group 等 类 组 织 窗口 界面 中 的 内 容 ， 这 一 节 我 们 来 看 看 
如 何 配置 窗口 本 身 的 属性 。 
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通过 kind 属 性 可 以 修改 View 对 象 的 显示 类 型 : 


'modal' : 模式 窗口 , 非 即 时 更 新 

‘live’: 非 模式 窗口 ， 即 时 更 新 

‘livemodal': 模式 窗口 ， 即 时 更 新 

'nonmodal' : 非 模式 窗口 ， 非 即时 更 新 

‘wizard! : 向 导 类 型 

‘panel’: 伐 入 到 其 它 窗口 中 的 面板 ， 即 时 更 新 ， 非 模式 
‘subpanel' 


其 中 ‘modal, ‘live’, 'livemodal', 'nonmodal' 四 种 类 型 的 View 都 将 采用 窗口 显示 其 内 
容 。 所 谓 模式 窗口 ， 表 示 此 窗口 关闭 之 前 ， 程 序 中 的 其 它 窗 口 都 不 能 被 激活 。 而 即 
时 更 新 则 是 指 当 窗口 中 的 控件 内 容 改变 时 ， 修 改 会 立即 反应 到 窗口 所 对 应 的 模型 数 
据 上 ， 非 即时 更 新 的 窗口 则 会 复制 模型 数据 ， 所 有 的 改变 在 模型 副本 上 进行 ， 只 有 
当 用 户 确定 修改 (通常 通过 OK 或 者 Apply 按 钮 ) 时 ， 才 会 修改 原始 数据 。 


'Wizard' 由 一 系列 特定 的 向 导 窗口 组 成 ， 属 于 模式 窗口 ， 并 且 即 时 更 新 数据 。 


'panel' 和 'subpanel' 则 是 内 入 到 窗口 中 的 面板，panel 可 以 拥有 自己 的 命令 按钮 ， 而 
subpanel 则 没有 命令 按钮 。 


命令 按钮 


在 对 话 框 中 经 常 可 以 看 到 OK, Cacel, Apply 之 类 的 按 妞 ， 我 们 称 之 为 命令 按钮 ， 它 
们 完成 所 有 对 话 框 窗口 都 共同 的 操作 。 在 TraitsUl 中 ， 这 些 按 钮 可 以 通过 View 对 象 
的 buttons 属 性 进行 设置 ， 其 值 为 要 显示 的 按钮 列表 。 


TraitsUl 定 义 了 UndoButton, ApplyButton, RevertButton, OKButton, CancelButton 
等 六 个 标准 的 命令 按钮 ， 每 个 按钮 对 应 一 个 名 字 ， 在 指定 buttons 属 性 时 ， 可 以 使 用 
按钮 的 类 名 或 者 其 对 应 的 名 字 。 和 与 按钮 类 对 应 的 名 字 就 是 类 名 除去 Button， 例 如 
UndoButton 对 应 为 "Undo"。 


在 enthought.tratis.ui.menu 中 还 预定 义 了 一 些 命 令 按 钮 列表 ， 方 便 直 接 使 用 : 


OKCancelButtons = ~*[OKButton, CancelButton ] 
ModalButtons = ``[ ApplyButton, RevertButton, OKButton, CancelButt« 
LiveButtons = ``[ UndoButton, RevertButton, OKButton, CancelButton, 
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Chaco- 交 互 式 图 表 


Chaco 是 一 个 2D 的 绘图 库 ， 如 果 你 安装 了 Python(x,y) 的 话 ， 可 以 在 pythonxy 的 安装 
目录 下 的 找到 Chaco 的 demo 程 序 : 


import numpy as np 
from enthought.chaco.shell import * 


X 
y 


np.linspace(-2*np.pi, 2*np.pi, 100) 
np.sin(x) 


plot(x, y, "r-") 
title("First plot") 
ytitle("sin(x)") 
show( ) 
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First plot 





用 Chaco 的 脚本 绘图 方式 快速 绘制 正弦 波 


plot 函 数 的 第 三 个 参数 中 的 "r" 指 定 绘图 的 颜色 为 红色 ，"-" 指 定 绘图 的 线 型 为 实 线 。 
title 画 数 为 绘图 添加 标题 ，ytitle 为 Y 轴 添加 标题 ，show() 画 数 最 终 显示 绘图 结果 。 


脚本 绘图 不 是 Chaco 的 强项 ， 虽 然 它 的 这 套 脚 本 绘图 API 和 Matplotlib 的 pylab 类 似 ， 
不 过 它 提 供 的 功能 却 没有 pylab 丰 富 。Chaco 的 优势 在 于 它 可 以 很 方便 地 铬 入 到 你 的 
应 用 程序 之 中 ， 开 发 出 自己 独特 的 绘图 应 用 。 


面向 应 用 绘图 


要 将 Chaco 谨 入 到 别 的 应 用 程序 之 中 ， 需 要 做 一 些 额 外 的 工作 ， 因 此 代码 量 比 面向 
脚本 绘图 要 多 ， 不 过 同时 也 更 具有 灵活 性 。 先 来 看 一 个 例子 : 


from enthought.traits.api import HasTraits, Instance 

from enthought.traits.ui.api import View, Item 

from enthought.chaco.api import Plot, ArrayPlotData 

from enthought.enable.component_editor import ComponentEditor 
from numpy import linspace, sin 


class LinePlot(HasTraits): 
plot = Instance(Plot) 
traits_view = View( 
Item('plot',editor=ComponentEditor(), show_label=False), 
width=500, height=500, resizable=True, title="Chaco Plot") 


def _ init (self): 

super(LinePlot, self).__init__() 

x = linspace(-14, 14, 100) 

y = sin(x) * x**3 

plotdata = ArrayPlotData(x=x, y=y) 

plot = Plot(plotdata) 

plot.plot(("x", "y"), type="line", color="blue") 

plot.title = "sin(x) * xA3" 

self.plot = plot 

if _name == "_ main_": 

LinePlot().configure_traits() 
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上 面 这 段 代码 绘制 如 下 的 曲线 : 
loi) 


sin(x) * x*3 





用 Chaco 的 面向 对 象 的 方式 绘制 曲线 


这 段 代 码 看 起 来 似乎 挺 复杂 ， 其 实 只 要 掌握 了 其 基本 设计 思想 ， 就 很 容易 理解 了 。 
首先 是 许多 import 语 句 ， 为 了 保持 应 用 程序 的 名 字 空 间 整 洁 以 及 让 自动 语法 检查 工 
具 能 帮助 我 们 检查 代码 ， 这 些 语句 只 import 了 需要 的 对 象 。 


e HasTraits, Instance : 这 两 个 从 traits 库 中 导入 ，HasTraits 是 所 有 拥有 Trait 属 性 
的 类 的 父 类 ， 我 们 自己 定义 的 LinePlot 类 继承 于 它 。 而 Instance 用 来 创建 一 个 
Trait 属 性 ， 此 属性 的 值 为 某 个 指定 的 类 的 实例 。 

e View, Item: 从 traits.ui 库 导入 ，View 用 来 创建 一 个 生成 用 户 界 面 用 的 视图 ， 而 
ltem 则 用 来 定义 视图 中 的 元 素 。 

e Plot, ArrayPlotData : 从 chaco 库 中 导入 ，Plot 本 身 是 一 个 描述 绘图 的 类 ， 它 的 
和 祖先 类 中 有 HasTraits， 因 此 它 本 身 也 是 一 个 拥有 trait 属 性 的 类 ，ArrayPlotData 
是 用 来 统一 保存 绘图 所 用 的 数据 的 类 。 也 就 是 说 Plot 管 理 绘图 ， 而 
ArrayPlotData 则 用 来 管理 绘图 所 用 的 数据 。 

e ComponentEditor : 从 enable 库 中 导入 ， 用 户 界 面 视图 中 使 用 
ComponentEditor 来 显示 LinePlot 类 的 plot 属 性 。 如 果 trait 属 性 为 Int、Str 或 者 
Float 之 类 的 简单 类 型 的 话 ， 系 统 能 够 自动 的 帮 我 们 选择 对 应 的 GUI 元 素来 显示 
它们 。 但 是 系统 不 知道 如 何 显示 Chaco 中 定义 的 Plot 这 样 的 的 类 型 ， 因 此 我 们 
必须 手工 指定 采用 ComponentEditor 来 显示 Plot。 

e linspace, sin: 从 numpy 库 中 导入 ，linspace 用 来 产生 一 个 等 差 数 列 ，numpy 中 
的 sin 函 数 可 以 自动 对 数组 中 的 每 个 元 素 进行 计算 。 


接 下 来 的 代码 部 分 : 


class LinePlot(HasTraits): 
plot = Instance(Plot) 


首先 定义 一 个 LinePlot 继 承 于 HasTraits， 并 且 它 有 一 个 trait 属 性 plot 为 Plot 类 的 实 
例 。 然 后 定义 视图 : 


traits_view = View( 
Item('plot',editor=ComponentEditor(), show_label=False), 
width=500, height=500, resizable=True, title="Chaco Plot") 


ay | 


此 视图 在 LinePlot 类 中 定义 ， 因 此 在 调用 configure_traits 的 时 候 就 不 需要 指定 视图 
了 。 视 图 中 有 一 个 元 素 ， 它 将 用 来 显示 名 为 plot 的 属性 的 内 容 ， 视 图 中 的 元 素 用 
Item 创建 。 注 意 这 里 使 用 字符 串 指定 视图 元 素 所 对 应 的 属性 。 然 后 通过 关键 字 参 数 
editor 指 定 此 视图 元 素 采 用 ComponentEditor 进 行 显示 。 并 且 不 显示 其 标签 
(show_label=False)。 通 过 View 的 关键 字 参 数 width、height、resizable 和 title 分 别 
指定 界面 的 宽 、 高 、 是 否 可 改变 大 小 以 及 其 窗口 标题 栏 的 文字 。 


接 下 来 看 构造 本 数 ， 真 正 的 计算 在 这 里 : 


def _ init__(self): 
super(LinePlot, self). _init_ () 
x = linspace(-14, 14, 100) 
y = sin(x) * x**3 
plotdata = ArrayPlotData(x=x, y=y) 
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能 才能 真正 在 我 们 的 实例 中 出 现 。 


接 下 来 和 脚本 绘图 一 样 ， 计 算出 绘图 所 需 的 x,y 坐 标的 数值 数组 。 然 后 将 这 两 个 数组 
存 到 一 个 ArrayPlotData 对 象 中 。ArrayPlotData 和 字典 (dict) 有 些 类 类 似 ， 它 将 一 个 字 
符 串 (数组 的 名 字 ) 和 数组 本 身 联 系 起 来 。 而 真正 的 绘图 对 象 plot 将 通过 数组 的 名 字 在 
A gaat, 获得 数组 的 内 容 。 这 样 做 就 在 数据 和 绘图 对 象 中 形成 了 一 个 接口 界 

修改 ArrayPlotData 中 的 数组 的 值 将 会 立即 反应 到 与 此 数据 相连 的 绘图 对 象 ， 而 
Bn 图 对 象 可 以 共用 ArrayPlotData 中 的 同一 数组 。 


接 下 来 创建 绘图 对 象 plot 和 给 它 ， 此 后 
plot 将 在 此 实例 中 获取 自己 绘图 所 需 的 数据 。 


plot = Plot(plotdata) 


Plot 类 将 Chaco 中 提供 的 许多 真正 用 来 绘图 的 对 象 进行 提供 了 一 个 统一 的 接 
口 用 来 创建 和 管理 这 些 绘图 对 象 。 TS 后 深入 学 习 ee ER t AT 
Plot 类 的 实现 来 了 解 Chaco 库 的 设计 思想 。 


接 下 来 调用 plot 方 法 在 Plot 内 部 创建 真正 的 绘图 对 象 ( 一 个 曲线 图 ): 


plot.plot(("x", "y"), type="line", color="blue") 


注意 我 们 传递 给 plot 方 法 的 是 数组 的 名 字 而 不 是 数组 本 身 ，Plot 对 象 会 自动 通过 数组 
ee 实例 中 找到 其 对 应 的 数组 。 


然后 设置 绘图 的 标题 ， 并 且 把 绘图 实例 赋值 给 plot 属 性 : 


plot.title = "sin(x) * x43" 
self.plot = plot 


最 后 是 LinePlot 对 象 的 实例 化 和 调用 configure_trait 显 示 绘 图 窗口 : 


if _name == " main _": 
LinePlot().configure_traits() 


由 于 没有 给 configure_traits 传 递 视图 参数 ， 它 将 在 LinePlot 实 例 中 寻找 视图 的 定 
义 ， 于 是 它 找到 traits_view， 并 且 用 此 视图 来 显示 LinePlot 实 例 的 trait 属 性 。 于 是 
plot 属 性 将 如 traits_view 中 定义 的 一 样 ， 用 ComponentEditor 显 示 。 


采用 和 LinePlot 类 同样 的 模式 ， 我 们 可 以 绘制 更 多 的 曲线 图 : 


from enthought.traits.api import HasTraits, Instance 

from enthought.traits.ui.api import View, Item 

from enthought.chaco.api import Plot, ArrayPlotData, Legend 
from enthought.enable.component_editor import ComponentEditor 
from numpy import linspace, sin, cos 


class LinePlot(HasTraits): 
plot = Instance(Plot) 
traits_view = View( 
Item('plot',editor=ComponentEditor(), show_label=False), 
width=500, height=500, resizable=True, title="Chaco Plot") 


def _ init (self): 
super(LinePlot, self).__init__() 
x = linspace(-14, 14, 100) 
y1 = sin(x) * x**3 
y2 = cos(x) * x**3 
plotdata = ArrayPlotData(x=x, yi=y1, y2=y2) 
plot = Plot(plotdata) 
plot.plot(("x", "y1"), type="line", color="blue", name="sir 
plot.plot(("x", "y2"), type="line", color="red", name="cosi 
plot.plot(("x", "y2"), type="scatter", color="red", marker 
marker_size = 2, name="cos(x) * x**3 points") 
plot.title = "Multiple Curves" 
self.plot = plot 


legend = Legend(padding=10, align="ur") 
legend.plots = plot.plots 
plot.overlays.append(legend) 
if _name == "_ main_": 
lineplot = LinePlot() 
lineplot.configure_traits() 
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Multiple Curves 


cos(x) * x**3 
e cos(x) * x**3 points 


sin(x) * x**3 





绘制 多 条 曲线 并 且 添 加 图 示 


在 这 个 程序 中 ， 我 们 调用 了 3 次 plot.plot 方 法 ， 其 中 两 次 的 type="line" 绘 制 曲 线 ， 一 
次 是 type="scatter" 绘 制 坐标 点 。 绘 制 坐标 点 时 通过 marker 和 marker_size 配 置 点 的 
形状 和 大 小 。 并 且 我 们 为 每 个 plot 传 递 了 一 个 name 参 数 。 


为 了 绘制 图 示 (legend)， 从 chaco.api 中 载 入 Legend 之 后 ， 使 用 如 下 三 行 代码 为 坐标 
图 添加 图 示 : : 


legend = Legend(component=plot, padding=10, align="ur") 
legend.plots = plot.plots 
plot.overlays.append(legend) 


其 中 第 一 行 创建 一 个 Legend 对 象 ， 并 且 设 置 padding 和 align 两 个 属性 ，padding 设 
置 其 内 容 与 边框 之 间 的 距离 ，align 设 置 其 在 容器 中 的 位 置 : upper right. 


为 了 让 legend 对 象 知 道 要 显示 什么 曲线 的 图 示 ， 我 们 需要 把 曲线 对 象 传递 给 它 。 三 


次 调用 plot 绘 制 的 曲线 可 以 通过 plot 对 象 plots 属 性 得 到 ， 在 iPython 中 运行 完 上 面 的 
程序 之 后 ， 输 入 lineplot.plot.plots 查 看 plots 属 性 的 值 : 


>>> lineplot.plot.plots 

{'cos(x) * x**3 points': [<enthought.chaco.scatterplot.ScatterPlot 
"cos(x) * x**3': [<enthought.chaco.lineplot.LinePlot object at 0x1: 
"sin(x) * x**3': [<enthought.chaco.lineplot.LinePlot object at 0x1: 


4 = = 
我 们 将 plot.plots 传 递 给 legend.plots， 于 是 legend 就 知道 要 显示 哪些 曲线 的 图 示 了 。 





后 我 们 将 legend 对 象 添 加 到 plot.overlays 中 。 a PS 层 ， 每 一 层 
放置 不 同 的 绘图 元 素 ，overlays 是 最 上 面 的 一 尼 ， 其 中 放 冒 在 屏幕 坐标 系 中 的 绘图 
元 素 。 plot 的 overlays 属 性 为 一 它 继承 于 list 类 ， 具 有 list 
的 所 有 能 力 ， 因 此 可 以 用 append 方 法 将 绘图 元 素 添 加 进 overlays 层 。 


容器 (Container) 概 述 


在 Chaco 的 实现 中 ，Plot 类 继承 于 DataView 类 ， 而 DataView 类 继承 于 
OverlayPlotContainer 类 ， 因 此 Plot 本 身 就 是 一 个 容器 。 可 以 把 
OverlayPlotContainer 想 象 成 多 张 透明 绘图 纸 ， 我 们 在 多 张 纸 上 绘 图 ， 然 后 通过 
OverlayPlotContainer 容 器 将 这 些 纸张 重 受 起 来 ， 就 组 成 了 最 终 所 绘制 的 图 。 


除了 OverlayPlotContainer 容 器 之 外 ，Chaco 还 提供 了 下 面 几 种 容器 : 


e HPlotContainer : 网 作风 二 
e VPlotContainer : 内 容 坚 向 排列 的 容器 
e GridPlotContainer : 内 容 按照 网 格 排列 的 容器 


下 面 让 我 们 来 看 一 个 用 HPlotContainer 的 例子 


from enthought.traits.api import HasTraits, Instance 

from enthought.traits.ui.api import View, Item 

from enthought.chaco.api import HPlotContainer, ArrayPlotData, Plot 
from enthought.enable.component_editor import ComponentEditor 

from numpy import linspace, sin 


class ContainerExample(HasTraits): 
plot = Instance(HPlotContainer ) 
traits_view = View(Item('plot', editor=ComponentEditor(), show. 
width=1000, height=600, resizable=True, tit- 
def _ init (self): 
super (ContainerExample, self). init _() 
x = linspace(-14, 14, 100) 
y = sin(x) * x**3 
plotdata = ArrayPlotData(x=x, y=y) 
scatter = Plot(plotdata) 


scatter.plot(("x", "y"), type="scatter", color="blue") 
line = Plot (plotdata) 
line.plot(("x", "y"), type="line", color="blue") 


container = HPlotContainer(scatter, line) 
self.plot = container 


if _ name == "” main _ 
ContainerExample().configure_traits() 


SSS eee 
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用 容器 绘制 两 个 子 图 


这 个 程序 和 前 面 的 例子 类 似 ， 所 不 同 的 是 : ContainerExample 的 plot 属 性 不 是 Plot 
的 实例 ， 而 是 改 为 HPlotContainer 的 实例 。 这 样 它 就 可 以 横向 排列 多 个 图 了 。 


在 _init 冰 数 中 ， 用 创建 两 个 Plot 对 象 scatter 和 line， 然 后 创建 HPlotContainer 对 
象 container， 并 把 两 个 plot 对 象 传递 给 它 ， 这 样 container 就 知道 要 水 平 排列 哪些 图 
To 


SBTBESARSRBEDLEE, WRRNE_init HARA RII PILATE 
FP: 


scatter.padding_right = 0 
line.padding_left = 0 
line.y_axis.orientation = "right" 


-ixi 





修改 两 个 容器 的 左右 padding 值 ， 使 它们 紧 靠 在 一 起 


我 们 看 到 两 个 Plot 之 间 的 间距 没有 了 ， 他 是 通过 设置 容器 左 图 (scatter) 的 右边 距 为 
0， 右 图 (line) 的 左边 距 为 0 来 实现 的 。 并 且 将 右 图 的 Y 轴 坐标 设置 到 了 右边 。 


编辑 绘图 属性 


到 目前 为 止 所 绘制 的 图 都 是 静态 的 ， 一 旦 创建 出 来 就 没有 办 法 改变 其 各 种 显示 属性 
了 。Chaco 库 是 建立 在 Traits 库 基础 之 上 的 ， 我 们 看 到 的 各 种 各 样 的 对 象 的 属性 都 是 
trait 属 性 ， 这 样 我 们 可 以 使 用 Traits= 和 TraitsUI 的 强大 功能 设置 对 象 的 各 种 属性 ， 下 

面 是 一 个 完整 的 例子 : 


from enthought.traits.api import HasTraits, Instance, Int, Color 
from enthought.traits.ui.api import View, Group, Item 

from enthought.enable.component_editor import ComponentEditor 
from enthought.chaco.api import marker_trait, Plot, ArrayPlotData 
from numpy import linspace, sin 


class ScatterPlotTraits(HasTraits): 


plot = Instance(Plot) 
color = Color("blue" ) 
marker = marker_trait 
marker_size = Int(4) 


traits_view = View( 
Group(Item('color', label="Color"), 
Item('marker', label="Marker"), 
Item('marker_size', label="Size"), 
Item('plot', editor=ComponentEditor(), show_label=Fa- 
orientation = "vertical"), 
width=800, height=600, resizable=True, title="Chaco 上 


def _ init__(self): 
super(ScatterPlotTraits, self).__init__() 
x = linspace(-14, 14, 100) 
y = sin(x) * x**3 
plotdata = ArrayPlotData(x = x, y = y) 
plot = Plot(plotdata) 


self.renderer = plot.plot(("x", "y"), type="scatter", coloi 
self.plot = plot 


def _color_changed(self): 
self.renderer.color = self.color 


def _marker_changed(self): 
self.renderer.marker = self.marker 


def _marker_size_changed(self): 
self.renderer.marker_size = self.marker_size 


if _name_ == " main_": 
ScatterPlotTraits().configure_traits() 


J E ea 


为 了 观察 trait 控 件 是 如 何 动态 地 修改 绘图 的 的 各 个 属性 ， 我 用 flash 录 制 下 对 控件 的 
操作 ， 请 点 击 下 图 下 方 的 播放 按钮 观看 动画 。 





通过 观察 上 面 的 这 个 动画 ， 我 们 发 现 对 颜色 、 点 型 和 点 的 大 小 等 属性 的 修改 立即 鸣 
应 到 绘图 的 属性 上 。 下 面 我 们 来 分 析 一 下 这 个 程序 : 


ScatterPlotTraits 类 定义 了 4 个 trait 属 性 ， 其 中 一 个 是 我 们 已 经 熟知 的 plot 属 性 ， 其 余 
的 三 个 分 别 为 color， e eee color 是 一 个 Color 属 性 ，marker_size 
是 一 个 Int 属 性 ，marker 比 较 特 别 ， 它 是 在 Chaco 的 scatter_ makers.py 中 定义 的 一 个 
Trait 属 性 ， 采 用 字典 创建 ， 将 一 个 描述 点 型 的 字符 串 映射 到 点 型 对 方 的 关 这 样 我 
ee ee eens 在 程序 内 部 实际 上 选择 的 是 其 对 


接 下 来 第 14 行 在 ScatterPlotTraits 类 内 部 定义 了 一 个 视图 对 象 traits_view。 它 创建 4 
个 ltem 分 别 与 4 个 trait 属 性 对 应 。 为 了 响应 trait 属 性 值 的 改变 事件 ， 我 们 为 类 添加 了 3 
| _marker_changed 和 _marker_size_changed。 

三 个 处 理 函 数 通 过 其 名 字 和 trait 属 性 对 应 ， 即 名 为 foo 的 trait 属 性 的 缺 省 事件 处 
TREES _foo_changed。 值 得 注意 的 是 这 三 个 义理 函数 是 和 trait 属 性 相对 应 的 ， 
而 不 是 界面 上 的 控件 。 当 用 户 更 改 了 控件 的 内 容 之 后 ， 此 更 改 自动 反映 为 trait 属 性 
值 的 更 改 ， ee ee Ba ba TE BO AR Ie IT, 1H, Hx HERAA 
行 的 时 候 ，trait 属 性 的 值 已 经 是 最 新 的 界面 上 所 显示 的 值 了 。 因 此 只 需要 将 此 值 赋 
值 给 曲线 fem 1 Condens SEAT, 


那么 render 对 象 是 什么 ?我 们 看 到 它 是 plot.plot 函 数 的 返回 值 ， 这 个 返回 值 就 是 图 中 
所 画 的 那 条 曲线 。 eo ee eae plots 获 得 过 plot 中 所 有 的 绘图 对 象 。 因 
此 不 用 render 保 存 此 返回 值 ， 也 可 以 用 plot.plots.values()[0]， 或 者 plot.plots["plot0"] 
来 获取 这 个 绘图 对 象 。"plot0" 是 系统 自动 为 我 们 的 曲线 所 起 的 名 字 。 


TVTK- 三 维 可 视 化 数据 


VTK (http://www.vtk.org/) 是 一 套 三 维 的 数据 可 视 化 工具 ， 它 由 C++ 编写 ， 包 酒 了 近 
千 个 类 帮助 我 们 处 理 和 显示 数据 。 它 在 Python 下 有 标准 的 绑 定 ， 不 过 其 API 和 
C++ 相同 ， 不 能 体现 出 Python 作为 动态 语言 的 优势 。 因 此 enthought.com 开 发 了 一 
套 TVTK 库 对 标准 的 VTK 库 进行 包装 ， 提 供 了 Python 风格 的 API、 支 持 Trait 属 性 和 
numpy 的 多 维 数组 。 本 文 将 以 TVTK 为 标准 对 VTK 的 一 些 功 能 进行 介绍 ， 如 果 读 者 
已 经 对 VTK 很 了 解 ， 想 知道 TVTK 和 VTK 的 区 别 的 话 ， 可 以 直接 跳 到 第 二 节 。 


TVTK 使 用 简介 


a 


显示 圆锥 
作为 第 一 例子 ， 让 我 们 来 看 一 个 显示 圆锥 的 小 程序 : 


# -*- coding: utf-8 -*- 
from enthought.tvtk.api import tvtk 


# 创建 一 个 圆锥 数据 源 ， 并 且 同 时 设置 其 高 度 ， 底 面 半 径 和 底面 圆 的 分 辩 率 (用 36 边 形 近 似 
cs = tvtk.ConeSource(height=3.0, radius=1.0, resolution=36) 
# 使 用 PolyDataMapper 将 数据 转换 为 图 形 数 据 
m tvtk.PolyDataMapper(input = cs.output) 
1 建 一 个 Actor 
tvtk.Actor(mapper=m) 
| 建 一 个 Renderer， 将 Actor 添 加 进去 
ren = tvtk.Renderer(background=(0.1, 0.2, 0.4)) 
ren.add_actor(a) 
# 创建 一 个 RenderWindow( 窗 口 )， 将 Renderer 添 加 进去 
rw = tvtk.RenderWindow(size=(300, 300) ) 
rw.add_renderer (ren) 
# 创建 一 个 RenderwindowInteractor (窗口 的 交互 工具 
rwi = tvtk.RenderWindowInteractor(render_window=rw) 
# 开启 交互 
rwi.initialize() 
rwi.start() 


| 
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此 程序 的 运行 画面 如 下 : 


FA Python 做 科学 计算 


MM Visualization Toolkit = Win320per 





使 用 TVTK 绘 制 简单 的 圆锥 
首先 从 tvtk.api 中 载 入 tvtk，tvtk 像 是 一 个 工厂 ， 能 够 帮助 我 们 创建 vtk 中 的 各 种 对 象 : 


>>> from enthought.tvtk.api import tvtk 


下 面 创建 了 一 个 ConeSource (圆锥 数据 源 ) 对 象 ， 并 用 变量 cs 保存 它 。 原 始 的 
VTK 对 象 的 属性 ， 在 tvtk 中 都 以 trait 属 性 的 形式 进行 包装 ， 因 此 我 们 可 以 在 创建 对 象 
的 同时 ， 传 递 关 键 字 参数 直接 配置 各 个 trait 属 性 的 值 ， 在 这 个 例子 中 ， 同 时 设置 了 
圆锥 的 高 度 ， 底 面 半 径 和 底面 圆 的 分 辨 率 ( 用 36 边 形 近 似 ) 等 属性 ， 最 后 调用 
print_traits 显 示 所 创建 的 圆锥 数据 的 所 有 trait 属 性 ， 为 了 节省 篇 幅 ， 这 里 只 挑选 了 其 
中 的 几 个 属性 : 


>>> cs = tvtk.ConeSource(height=3.0, radius=1.0, resolution=36) 
>>> cs.print_traits() 


angle : 18 . 43494882292201 
center: array([ ©., 0., 0.]) 
class_name: "vtkConeSource' 
direction: array([ 1., 0., 0.]) 
height: 3.0 

radius: 1.0 


resolution: 36 


TVTK- 三 维 可 祝 化 数据 114 


在 VTK 中 将 原始 数据 转换 为 我 们 看 到 的 屏幕 上 的 一 幅 图 像 ， 要 经 过 许多 步骤 的 外 

理 ， 这 些 步骤 由 众多 的 VTK 的 对 象 共同 协调 完成 ， 就 好 象 生产 线 上 加 工 需 件 一 样 ， 

每 位 工人 都 负责 一 部 分 的 工作 ， 整 条 生产 线 就 能 将 原材料 制作 成 产品 。 因 此 在 VTK 
中 ， 这 种 对 象 之 间 协 调 完成 工作 的 过 程 被 称 作 流水 线 (Pipeline)。 


原始 数据 被 转换 为 图 像 要 经 过 两 条 流水 线 : 


。 可 视 化 流水 线 (Visualization Pipeline): 它 的 工作 是 将 原始 数据 加 工 成 图 形 数 
据 。 通 常 我 们 需要 可 视 化 的 数据 本 身 并 不 是 图 形 数据 ， 例 如 某 个 震 件 内 部 各 个 
部 分 的 温度 ， 或 者 是 流体 在 各 个 坐标 点 上 的 速度 等 等 。 

。 图 形 流水 线 (Graphics Pipeline) : 它 的 工作 是 将 将 图 形 数据 加 工 为 我 们 所 看 到 
的 图 像 。 可 视 化 流水 线 所 产生 的 图 形 数据 通常 是 三 维 空 间 的 数据 ， 如 何在 二 维 
的 屏幕 上 显示 出 来 就 需要 图 形 流水 线 的 加 工 了 。 


映射 器 (Mapper) 则 是 可 视 化 流水 线 的 终点 ， 图 形 流水 线 的 起 点 ， 它 将 各 种 派生 类 能 
将 众多 的 数据 映射 为 图 形 数据 以 供 图 形 流水 线 加 工 。 


让 我 们 对 照 一 下 前 面 的 的 圆锥 的 例子 : ConeSource 的 对 象 通过 程序 内 部 计算 输出 
一 组 描述 圆锥 的 数据 (PolyData) : 然后 ，PolyData 通 过 PolyDataMapper 映 射 器 将 数 
据 映 射 为 图 形 数据 。 在 这 个 例子 中 ， 可 视 化 流水 线 由 ConSource 和 
PolyDataMapper 组 成 。 


图 形 数据 依次 通过 Actor、Renderer 最 终 在 RenderWindow 中 显示 出 来 ， 这 一 部 分 就 
是 图 形 流 水 线 。 


e Actor: 表示 润色 场景 中 的 一 个 实体 。 它 包括 一 个 图 形 数据 (mapper)， 并 且 具 
有 描述 实体 的 位 置 、 方 向 、 大 小 的 属性 。 

e Renderer: 表示 润色 的 场景 。 它 包括 多 个 需要 润色 的 Actor。 在 圆锥 的 例子 
中 ， 它 只 包括 一 个 表示 圆锥 的 Actor。 

e RenderWindow : 表示 润色 用 的 图 形 窗口 ， 它 包括 一 个 或 者 多 个 Render。 在 圆 
锥 的 例子 中 ， 它 只 包括 一 个 Renderer。 

e RenderWindowlnteractor : 给 图 形 窗 口 提供 一 些 用 户 交 互 功能 ， 例 如 平移 、 
旋转 、 放 大 缩小 。 这 些 交互 式 操作 并 不 改变 Actor 或 者 图 形 数据 的 属性 ， 只 是 调 
整 场景 中 的 照相 机 (Camera) 的 一 些 设置 而 已 。 


什么 是 PolyData 


PolyData 是 一 个 描述 一 组 三 维 空间 中 的 点 、 线 、 面 的 数据 结构 。 点 、 线 、 面 通过 以 
下 几 个 属性 描述 : 


e points : 类 型 为 Points， 保 存 三 维 空 间 中 的 点 的 坐标 的 数组 ， 这 些 数据 不 


是 用 来 显示 的 。 

e verts : 类 型 为 CellArray， 它 描述 需要 显示 的 顶点 ， 其 值 为 points 某 个 坐 
标点 的 下 标 ， 即 通过 verts 属性 描述 points 中 的 哪些 点 是 最 终 需 要 显示 
的 。 


e line: 类 型 为 CellArray， 它 摘 述 需要 显示 的 边线 ， 其 值 为 边线 的 两 个 端点 
在 points 中 的 下 标 。 
e polys : 类 型 为 CellArray， 它 描述 


在 points 中 的 下 标 。 


需要 显示 的 面 ， 其 值 为 构成 面 的 各 个 点 


用 ivtk 观 察 流水 线 


为 了 方便 我 们 操作 和 观察 流水 线 ， 交 互 式 地 修改 各 个 tvtk 对 象 的 属性 ，TVTK 库 为 我 
们 提供 了 一 个 叫做 ivtk 的 对 象 。 下 面 是 使 用 ivtk 显 示 圆 锥 的 程序 : 


# -*- coding: utf-8 -*- 
from enthought.tvtk.api import tvtk 


# 载 人 ivtk 所 需要 的 对 象 
from enthought.tvtk.tools import ivtk 
from enthought.pyface.api import GUI 


s = tvtk.ConeSource(height=3.0, radius=1.0, resolution=36) 
tvtk.PolyDataMapper(input = cs.output) 


C 
m 
a tvtk.Actor(mapper=m) 


# 创建 一 个 GUI 对 象 ， 和 一 个 带 Crust(Python she11) 的 ivtk 窗 口 
gui = GUI() 

window = ivtk.IVTKWithCrustAndBrowser (size=(800, 600) ) 
window. open( ) 

window.scene.add_actor( a ) # 将 圆锥 的 actor 添 加 进 窗口 的 场景 
gui.start_event_loop() 

#window.scene.reset_zoom() 


此 程序 的 运行 画面 如 下 : 
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>>> print cs.output.points.to array() 
[[ 121.50000000e+00 0.00000000e+00 

[ -1.50000000e+00 -900000000e+00 
[ -1.50000000e+00 -84807730e-01 
[ -1.50000000e+00 -39692616e-01 
[ -1.50000000e+00 -66025388e-01 
[ -1.50000000e+00 -66044438e-01 
[ -1.50000000e+00 -42787635e-01 
[ -1.50000000e+00 -00000000e-01 
[ 
[ 
[ 
[ 
[ 


.00000000e+00) 
.00000000e+00] 
.73648179e-01] 
.42020154e-01] 
.00000000e-01] 
.42787635e-01] 
.66044438e-01] 
. 66025388e-01] 
.39692616e-01] 
.84807730e-01] 
.00000000e+00] 
.84807730e-01] 
.39692616e-01] 


oun) © wo wo Fe 


-1.50000000e+00 -42020154e-01 
-1.50000000e+00 - 73648179e-01 
-1.50000000e+00 -05103434e-10 
-1.50000000e+00 - 73648179e-01 
-1.50000000e+00 -42020154e-01 
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带 流水 线 浏览 器 和 Python Shell 的 界面 
除了 显示 圆锥 的 场景 之 外 ，ivtk 创 建 的 窗口 还 为 我 们 提供 了 如 下 几 个 元 素 : 


。 场景 工具 条 : 位 于 润色 场景 的 上 方 。 主 要 提供 了 各 种 视角 、 全 屏 显 示 、 保 存 图 
像 等 几 个 功能 。 

e 流水 线 浏 览 器 : 场景 的 左边 是 一 个 用 树 状 2 吉 构 表示 的 流水 线 。 从 叶子 节点 
(ConeSource) 开 始 逐 步 向 上 层 直 到 根 节点 RenderWindow， 是 完整 的 显示 圆锥 
的 流水 线 。 

e Python Shell : 下 方 提 供 了 一 个 Python Shell， 便 于 我 们 直接 输入 命令 操作 各 
个 对 象 。 例 如 图 中 我 们 打印 出 ConeSource 的 输出 PolyData 的 points 属 性 的 值 。 
即 构 成 圆锥 图 形 的 各 个 点 的 三 维 坐标 。 


流水 线 浏览 器 中 显示 的 各 个 对 象 的 类 型 都 继承 于 HasTraits 类 ， 因 此 它们 都 可 以 提供 
一 个 用 户 界面 交互 式 地 修改 它们 的 trait 属 性 。 下 图 是 双击 ConeSource 之 后 出 现 的 修 
改 ConeSource 属 性 的 界面 。 


Note 
在 我 的 电脑 上 ， 双 击 ConeSource 之 后 出 现 一 个 很 小 的 窗口 ， 需 要 手工 调整 大 小 。 
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ŝa Edit ConeSource properties = | 口 | x| 
View type:| Basic "| 














Capping: M 


Angle: [18.4349488229 —ss—“‘“—s—i‘“‘“‘“‘i‘i‘i‘is;s™sSCS 
Center: Foloo Fo Fo | 
Direction: Fllo Fo Fo 

Height: 0.000 Ce see) [3.000 | 
Radius: 0.000 中 _ > 11.000 [1.000 — 


Resolution: | 36 =| 








OK | Cancel | 


编辑 ConeSource 对 象 的 属性 的 对 话 框 


我 们 看 到 可 以 通过 此 界面 直接 修改 height、Radius、resolution 等 属性 ， 并 且 修 改 之 
后 场景 中 的 圆锥 按照 最 新 的 属性 值 立 即 更 新 显示 。 


从 文件 读 取 数 据 


大 多 数 情 况 下 我 们 不 会 只 用 VTK 显 示 圆 锥 这 样 的 简单 物体 ， VTK 的 建 模 功能 并 不 强 
大 ， 因 此 它 支 持 许多 种 格式 的 文件 ， 能 将 其 它 软件 产生 的 数据 通过 各 种 Reader 类 读 
入 VTK， 放 到 流水 线 上 人 处理 。 下 面 的 例子 从 文件 42400 IDGH.stl 中 载 入 模型 数据 ， 
并 且 润 色 显 示 。 


# -*- coding: utf-8 -*- 

from enthought.tvtk.api import tvtk 
from enthought.tvtk.tools import ivtk 
from enthought.pyface.api import GUI 


part =tvtk.STLReader(file_name = "42400-IDGH.st1") 
part_mapper = tvtk.PolyDataMapper( input = part.output ) 
part_actor = tvtk.Actor( mapper = part_mapper ) 


gui = GUI() 

window = ivtk.IVTKWithBrowser (size=(800, 600) ) 
window. open( ) 

window.scene.add_actor( part_actor ) 
gui.start_event_loop() 


此 程序 的 运行 画面 如 下 : 


用 Python 做 科学 计算 


PS TVTK Scene 
File Edit View 


(epee twee Ok 


E C] Win32OpenGLRenderWindow 
| (5) OpenGL Painter Device Adapter 
E-A Renderer 
a Actor 
i 日 D PolyDataMapper 
i: i 日 g Poly Data 
a- AleorithmOutput 
= STLReader 
i MergePoints 
[i] LookupTable 
iE] OpenGLProperty 
BN OpenGLCamera 





显示 文件 中 的 3D 模 型 


对 比 显示 圆锥 的 程序 ， 除 了 PolyDataMapper 的 输入 从 ConeSource 改 为 STLReader 
之 外 ， 其 他 的 部 分 没有 任何 区 别 。STLReader 对 象 知道 如 何 读 取 STL 文 件 中 的 数 
据 ， 并 且 转 换 为 PolyData， 以 供 PolyDataMapper 使 用 。 另 外 请 注意 我 们 这 次 用 
ivtk.|IVTKWithBrowser 产 生 一 个 不 带 Python Shell 的 ivtk 窗 口 。 


STL 是 什么 文件 


STL 的 全 称 为 stereo-lithography， 由 3D Systems 公 司 开发 ， 它 使 用 三 角形 面 片 来 表 
示 三 维 实 体 模型 ， 现 已 成 为 CAD/CAM 系 统 接口 文件 格式 的 工业 标准 之 一 ， 绝 大 多 
数 造型 系统 能 支持 并 生成 此 种 格式 文件 。 例 子 中 的 42400-IDGH.stl 文 件 来 自 于 VTK 
的 示例 数据 。 笔 者 对 模具 设计 没有 研究 ， 只 是 照 葫 莒 画 球 ， 把 VTK 的 例子 转换 为 
TVTK 而 已。 


过 滤 数 据 


前 面 的 例子 中 包括 一 个 数据 源 和 mapper 对 象 ， 但 是 流水 线 中 没有 过 滤器 对 数据 进行 
过 滤 ， 下 面 我 们 看 看 如 何 对 数据 进行 过 滤 以 减少 多 边 形 面 的 数量 。 对 上 节 的 程序 进 
行 修改 ， 在 STLReader 和 PolyDataMapper 之 间 插 入 一 个 ShrinkPolyData 对 象 : 


part =tvtk.STLReader(file_name = "42400-IDGH.st1") 
shrink = tvtk.ShrinkPolyData(input = part.output, shrink_factor = ( 
part_mapper = tvtk.PolyDataMapper( input = shrink.output ) 


回 Bs 


ShrinkPolyData 过 滤器 的 输入 和 输出 都 是 PolyData， 它 可 以 减少 输入 PolyData 对 象 
中 单元 (点 线 面 ) 的 数目 ， 但 是 会 造成 不 单元 之 间 不 连续 。 
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FA Python 做 科学 计算 





使 用 ShrinkPolyData 过 滤器 过 滤 后 的 模型 


控制 照相 机 


如 果 你 使 用 ivtk 显 示 3D 数 据 的 话 ， 在 左边 的 流水 线 浏 览 器 中 可 以 找到 
OpenGLCamera， 双 击 它 弹 出 如 下 窗口 : 
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£3 Edit OpenGLCamera properties mfe x| 
| View type:| Basic "| | 


Parallel projection: 三 
Use horizontal view angle: 厂 


Clipping range: FO:| 13.2524358412 F1:| 45.3852420139 


Distance: [27.4487718098 
Eye angle: [2.0 ”了 


Focal disk: | 1.0 


Focal point: F0:{128.42124939 ， F1:[86.5079574585  F2:[223.488082886 
Left eye: Poo 

Parallel scale: [8.81174560314 
Position: F0:[131.583926736 F1:[60.4965164295  F2:[215.312663541 | 


Thickness: | 32.1328061727 
View angle: lB300 
View plane normal: FO: 0.115221087781 F1;|-0.94763588000 F2:| -0.29784281066 


View shear: Fo:| 0.0 F1;| 0.0 F2:| 1.0 
View up: Fo:| -0.13173879264 F1;| 0.28261342044: F2:| -0.95014448643 
Window center: Fo:| 0.0 F1;| 0.0 











OK | Cancel | 





编辑 照相 机 属性 的 对 话 框 


这 个 窗口 显示 的 是 3D 场 景 的 照相 机 的 所 有 配置 。 如 果 你 需要 用 程序 控制 照相 机 的 
话 ， 可 以 用 : 


>>> camera = window.scene.renderer.active_camera 


获得 场景 中 的 当前 照相 机 对 象 ， 然 后 就 可 以 获得 或 者 修改 照相 机 的 各 项 配置 


>>> camera.clipping_rage 
array([ 20.46912341, 51.21854284]) 
>>> camera.view_up = 0,1,0 


下 面 介绍 一 些 照 相机 的 一 些 常 用 属性 : 


。 clipping_plane : 它 有 两 个 元 素 ， 分 别 表示 照相 机 到 近 、 远 两 个 裁剪 平面 的 距 
离 。 在 这 两 个 下面 之 外 的 对 象 将 不 会 被 显示 出 来 。 

e position : 照相 机 在 三 维 空 间 中 的 坐标 

e focal_point: 照相 机 所 聚焦 的 焦点 坐标 

e View_up : 照相 机 的 上 方向 矢量 





e parallel_projection : 如 果 为 True 的 话 表 示 采 用 平行 透视 ， 即 在 3D 场 景 中 平行 
的 线 投 影 到 2D 平 面 上 将 仍然 是 平行 的 


这 些 属性 虽然 可 以 完全 控制 照相 机 的 位 置 和 方向 ， 但 是 实际 操作 起 来 并 不 方便 。 当 
: 以 焦点 为 圆心 ， 治 着 纬度 线 旋 转 指 定 角度 ， 即 水 平 旋转 ， 改 变 其 经 度 

e elevation: 治 着 经 度 线 方 向 旋转 指定 角度 ， 即 垂直 旋转 ， 改 变 其 纬度 
MR i i eee 这 两 个 函数 保持 view_up 属 性 
控制 照明 
照明 比照 相机 容易 配置 得 多 ， 假 设 你 运行 了 ivtk 的 圆锥 的 例子 的 话 ， 直 接 在 窗口 下 
方 的 命令 行 中 输入 : 


>>> camera = window.scene.renderer.active_camera 
>>> light = tvtk.Light(color=(1,0,0)) 

>>> light.position=camera.position 

>>> light.focal_point=camera.focal_point 

>>> window.scene.renderer.add_light(light ) 


. TODO 即 可 在 照相 机 所 在 处 添加 一 个 红色 的 光源 ， 它 的 照射 方向 为 朝向 

focal _point 点 。 如 果 你 设置 light 的 positional 属 性 为 True 的 话 ， 那 么 它 就 变 成 一 个 探 
照 灯 光源 ， 这 时 照射 方向 有 效 。 并 且 可 以 通过 cone_angle 属 性 设置 探照灯 的 光 锥 角 
度 。 光 锥 为 180 度 的 话 ， 就 是 无 方向 光源 。 


控制 3D Props 


在 3D 场 景 中 显示 的 物体 通常 被 称 作 prop， 有 几 种 prop 类 型 ， 其 中 包括 : Prop3D 和 
Actor。3D 场 景 中 所 有 prop 的 都 从 Prop3D 继 承 。 


TVTK 的 改进 


下 面 是 使 用 Python 的 标准 VTK 库 显示 一 个 圆锥 的 例子 : 


import vtk 


# Source object . 

cone = vtk.vtkConeSource( ) 
cone.SetHeight( 3.0 ) 

cone.SetRadius( 1.0 ) 
cone.SetResolution(10) 

# The mapper . 

coneMapper = vtk.vtkPolyDataMapper( ) 
coneMapper.SetInput( cone.GetOutput( ) ) 
# The actor. 

coneActor = vtk.vtkActor( ) 
coneActor.SetMapper ( coneMapper ) 

# Set it to render in wireframe 
coneActor.GetProperty( ).SetRepresentationToWireframe( ) 


# Renderer and render window . 

rent = vtk.vtkRenderer( ) 
reni.AddActor( coneActor ) 
reni.SetBackground( 0.1, 0.2, 0.4 ) 
renWin = vtk.vtkRenderWindow(_ ) 
renwWin.AddRenderer( rení ) 
renWin.SetSize(300 , 300) 


# On screen interaction . 

iren = vtk.vtkRenderwWindowInteractor( ) 
iren.SetRenderWindow( renWin ) 
iren.Initialize( ) 

iren.Start( ) 


我 们 可 以 出 这 个 例子 和 C++ 的 程序 的 区 别 仅 仅 是 没有 声明 变量 的 类 型 ， 其 它 的 用 法 
完全 是 按照 C++ 的 VTK API 调 用 的 。 官 方 所 提供 的 VTK-Python 包 和 C++ 语言 的 接口 
相似 ， 许 多 地 方 没有 能 够 体现 出 Python 作为 动态 语言 的 优势 ， 可 以 说 标准 的 VTK- 
Python 库 不 够 Python 风 格 。 为 了 弥补 标准 库 的 这 些 不 足 之 处 ，Enthought.com 开 发 
了 TVTK 库 进一步 对 VTK 进 行 包装 ， 它 具有 如 下 的 一 些 优点 : 


支持 Trait 属 性 

支持 元 素 的 Pickle 操 作 

API 更 接近 Python 风格 

能 自动 处 理 numpy 的 数组 或 者 Python 的 列表 
高 级 的 脚本 式 的 mlab API， 和 流水 线 浏览 器 ivtk 
tvtk 的 场景 和 流水 线 浏 览 器 支持 Envisage 插 件 


TVTK 的 基本 用 法 
下 面 是 用 TVTK 实 现 上 面 的 显示 圆锥 的 例子 


from enthought.tvtk.api import tvtk 


cone = tvtk.ConeSource( height=3.0, radius=1.0, resolution=10 ) 
cone_mapper = tvtk.PolyDataMapper( input = cone.output ) 
cone_actor = tvtk.Actor( mapper=cone_mapper ) 
cone_actor.property.representation = "w" 


rent = tvtk.Renderer() 
reni.add_actor( cone_actor ) 
reni.background = 0.1, 0.2, 0.4 
ren_win = tvtk.RenderWindow( ) 
ren_win.add_renderer( rení ) 
ren_win.size = 300, 300 


iren = tvtk.RenderWindowInteractor( render_window = ren_win ) 
iren.initialize() 
iren.start() 


可 以 看 到 这 个 程序 比 标 准 VTK 版 本 要 简短 得 多 ， 从 中 我 们 可 以 看 到 TVTK 的 一 些 重 
要 的 更 改 : 


e tvtk 用 from enthought.tvtk.api import tvtk 语句 载 人 

o tvtk 的 类 名 为 VTK 的 类 名 除去 前 级 "vtk"。 有 些 类 名 在 "vtk" 之 后 是 数字 : 
vtk3DSImporter, 由 于 Python 的 标示 符 首 字符 不 能 为 数字 ， 因此 tvtk 对 此 进行 
特殊 处 理 :如 果 首 字符 为 数字 ， 则 用 其 英文 单词 代替 : ThreeDSImporter。 

e tvtk 对 象 的 方法 名 按照 Enthought 的 一 贯 用 法 ， 采 用 下 划 线 连接 单词 : 例如 如 果 
VTK 中 的 Addltem， 将 对 应 tvtk 中 的 add_item。 

。 许多 VTK 的 方法 在 tvtk 中 用 trait 属 性 蔡 代 ， 例 如 前 面 的 例子 中 我 们 用 m.input = 
cs.output 表 示 VTK 中 的 m.Setlnput(cs.GetOutput())，p.representation = 'w' 表 
示 VTK 中 的 p.SetRepresentationToWireframe()。 由 于 在 VTK 中 许多 需要 用 Set, 
Get 的 属性 在 TVTK 中 都 是 以 Trait 属 性 表现 的 ，Trait 属 性 的 初始 化 可 以 在 产生 对 
象 的 同时 进行 配置 。 

。 trait 属 性 可 以 在 创建 类 的 对 象 的 同时 通过 关键 字 参 数 进 行 设 置 


在 内 部 实现 中 ， 所 有 的 tvtk 对 象 都 内 部 包装 有 一 个 VTK 对 象 ， 对 tvtk 对 象 的 方法 的 调 
用 将 转 给 相应 的 VTK 对 象 的 方法 执行 ， 如 果 返 回 值 是 VTK 对 象 的话 ， 将 被 包装 成 
tvtk 对 象 返 回 。 如 果 方 法 的 参数 是 tvtk 对 象 的话 ， 其 中 的 VTK 对 象 业 传递 给 VTK 的 方 
法 。 


通过 调用 tvtk.to_tvtk(p)， 可 以 得 到 p 中 所 包装 的 VTK 对 象 


Trait 属 性 


所 有 的 tvtk 类 都 继承 于 traits.HasStrictTraits，HasStrictTraits 规 定 了 它 的 子 类 的 对 象 
在 创建 之 后 不 站 bE 对 不 存在 的 属性 进行 赋值 。 


VTK 中 所 有 和 基本 状态 有 关 的 的 方法 在 tvtk 中 都 以 trait 属 性 表示 。trait 属 性 为 我 们 带 
来 如 下 的 便利 : 


e 通过 调用 set 方 法 可 以 一 次 设置 多 个 trait 属 性 : 


>>> p = tvtk.Property() 
>>> p.set(opacity=0.5, color=(1,0,0), representation="w" ) 


e 通过 调用 edit_traits 或 者 configure_traits 方 法 直接 出 界面 编辑 属性 。 对 trait 属 性 
的 更 改 将 自动 作用 到 内 部 的 VTK 对 象 之 上 ， 反 过 才 来 ， 内 部 的 VTK 对 象 的 状态 改 
变 也 将 自动 更 新 trait 属 性 。 下 面 是 一 个 例子 


>>> p.edit traits() 


ŝa Edit Property properties - (5) x| 









View type: HERS 











Backface culling: 三 
Edge visibility: 三 
Frontface culling: 三 
Lighting: V 
Shading: 三 


hterpolation: Jeouraud = | 
Representation: [wirefra me "| 


Ambient: 0. 
Ambient color: 
Color: 

Diffuse: D. 
Diffuse color: 
Edge color: 


Line stipple pattern: 


Line stipple repeat factor: 1 
Line width: 0.000 © -上 一 一 © 11.000 Jooo 
iofs 
Point size: 000 © - — © 11.000 [oo 
Specular: 00 H 10 joo 
Specular color: (O00) | 
Specular power: 0.000 © - | 一 一 四 11.000 Jooo ~| 


Cancel | 


每 个 TVTK 对 象 都 可 以 有 自己 的 编辑 属性 的 对 话 框 界面 
。 我 们 可 以 通过 tvtk.to_tvtk(p) 范 数 得 到 任何 tvtk 对 象 所 包装 的 TVK 对 象 : 








Opacity: 0.0 





>>> print p.representation 

wireframe 

>>> p_vtk = tvtk.to_vtk(p) 

>>> p_vtk.SetRepresentationToSur face( ) 
>>> print p.representation 

surface 


序列 化 (Pickling) 
tvtk 对 象 支持 简单 的 序列 化 处 理 。 单 个 tvtk 对 象 的 状态 可 以 被 序列 化 : 


>>> import cPickle 

>>> p = tvtk.Property() 
>>> p.representation="W" 
>>> s = cPickle.dumps(p) 
>>> del p 

>>> q = cPickle.loads(s) 
>>> q.representation 
'wireframe' 


但 是 序列 化 仅仅 能 保存 对 象 的 状态 。 对 象 之 间 的 引用 无 法 被 保存 。 因 此 VTK 的 整个 
流水 线 无 法 用 序列 化 保存 。 


通常 pickle.load 将 创建 新 的 对 象 ， 如 果 我 们 希望 更 新 某 个 已 经 存在 的 对 象 的 状态 的 
话 ， 可 以 如 下 调用 : 


>>> p = tvtk.Property() 


>>> p.interpolation = "flat" 
>>> d = p. getstate () 
>>> del p 


>>> q = tvtk.Property() 
>>> q.interpolation 
'gouraud' 

>>> q.__setstate__(d) 
>>> q.interpolation 
'flat' 


集合 迭代 
从 tvtk.Collection 继 承 的 对 象 可 以 像 标 准 的 Python 序列 对 象 一 样 使 用 : 


>>> ac = tvtk.ActorCollection() 
>>> len(ac) 


>>> ac.append(tvtk.Actor()) 
>>> ac.append(tvtk.Actor()) 
>>> len(ac) 


>>> for a in ac: 
print a 


vtkOpenGLActor (O6A99EB8) 


>>> del ac[0] 
>>> len(ac) 
1 


我 们 看 到 ActorCollection 可 以 像 Python 的 列表 对 象 一 样 支持 len, append 和 for 循 环 。 
对 比 一 下 VTK 的 相应 的 版 本 ， 就 能 体会 出 tvtk 的 好 处 了 : 


>>> ac = vtk.vtkActorCollection() 
>>> ac.GetNumberofItems( ) 


>>> ac.AddItem(vtk.vtkActor()) 
>>> ac.AddItem(vtk.vtkActor()) 
>>> ac.GetNumberOfiItems( ) 


>>> ac.InitTraversal() 
>>> for i in range(ac.GetNumberOfiItems()): 
print ac.GetNextItem() 


vtkOpenGLActor (05E0A750) 


>>> ac.RemovelItem(0) 
>>> ac.GetNumberOfItems( ) 
1 


数组 操作 


所 有 继承 于 DataArray 类 的 对 象 科 Python 的 序列 一 样 ， 支 持 迭 代 接 口 ， 以 及 
__getitem__,__setitem__,__repr__, append, extend 等 等 。 此 外 ， 它 还 可 以 直接 
用 numpy 的 数组 或 者 python 的 列表 直接 进行 赋值 (使 用 rom_array 方 法 )， 或 者 将 
DataArray 中 保存 的 数据 转换 为 numpy 的 数组 。Points 和 IdList 等 类 也 同样 支持 这 些 
特性 : 








>>> pts = tvtk.Points() 
>>> p_array = np.eye(3) 
>>> p_array 
array([[ 1., ©., 90.], 
L o., 1., 0.]， 
[ 0., 0., 1.]]) 
>>> pts.from_array(p_array) 
>>> pts.print_traits() 


_in_set: 0 

_vtk_obj: <vtkCommonPython.vtkPoints vtkobject at Ot 
actual_memory_size: 1L 

bounds: (0.0, 1.0, 0.0, 1.0, 0.0, 1.0) 

class_name: 'vtkPoints' 

data: IELO oror 020 (00r 10r 00), (00r 
data_type: ' double ' 

number_of_points: 3 

reference_count: 1 


>>> pts.to_array() 
array([[ 1., ©., 90.], 


X omir 
[ 0., ©., 1.]]) 





此 外 tvtk 的 方法 或 者 属性 如 果 接 受 DataArray Points, IdList 或 者 CellArray 的 对 象 的 
话 ， 那 么 它 也 同时 支持 数组 和 列表 : 


>>> points = np.array([[0,0,0], [1,0,0], [0,1,0], [0,0,1]], 'f') 
>>> triangles = np.array([[0,1,3], [0,3,2], [1,2,3], [0,2,1]]) 

>>> values = np.array([1.1, 1.2, 2.1, 2.2]) 

>>> mesh = tvtk.PolyData(points=points, polys=triangles) 

>>> mesh.point_data.scalars = values 

>>> mesh.points 

ETOO 070). 6-0), (G0, 02, O20). (020, 2.0, 0.0) e 0.0, 1.0) 
>>> mesh.polys 

<tvtk_classes.cell_array.CellArray object at 0x142D4F60> 

>>> mesh.polys.to_array() 

array([3, ©, 1, 3, 3, 0, 3, 2, 3, 1, 2, 3, 3, 0, 2, 1]) 

>>> mesh.point_data.scalars 

[1.1000000000000001, 1.2, 2.1000000000000001, 2.2000000000000002 |] 


S| 


注意 CellArray 类 (mesh 的 polys 属 性 ) 的 处 理 有 所 不 同 ， 我 们 给 它 传人 的 是 一 个 二 维 
数组 ， 在 内 存 中 保存 的 却 是 一 维 的 : array([3, 0, 1, 3, 3, 0, 3, 2, 3, 1, 2, 3, 3, 0, 2, 
1])。 它 的 格式 是 [Cell 的 数据 个 数 , Cell 数 据 .… Cell 的 数据 个 数 , Cell 数 据 ...]， 如 下 图 
所 示 。 

CellArray 用 来 描述 多 边 形 (Cell) 和 顶点 之 间 的 关系 ， 由 于 每 个 Cell 可 以 由 不 同 数 量 的 
定点 组 成 ， 因 此 内 部 采用 上 面 所 述 的 形式 保存 。 


TVTK 是 什么 


我 们 通过 from enthought.tvtk.api import tvtk 载 入 tvtk， 然 后 像 使 用 一 个 模块 一 样 使 
用 它 。 事 实 上 ， 我 们 载 人 的 tvtk 并 不 是 一 个 模块 ， 而 是 某 个 类 的 一 个 实例 。 之 所 以 
会 如 此 设计 ， 是 因为 VTK 库 有 近 千 个 类 ， 而 TVTK 对 所 有 这 些 类 都 进行 了 包装 ， 如 
果 一 次 性 载 入 这 人 么 多 类 ， 会 极 大 地 影响 库 的 载 人 速度 。 
我 们 载 和 的 tvtk 虽 然 是 某 个 类 的 实例 ， 但 是 用 起 来 就 和 模块 一 样 : 

。 通过 tvtk 对 象 可 以 使 用 所 有 的 TVTK 类 

。 它 不 需要 载 入 近 干 个 TVTK 类 就 能 支持 类 名 的 自动 完成 

。 只 有 在 真正 使 用 某 个 TVTK 类 时 ， 它 才 会 被 载 入 
所 有 tvtk 相 关 的 代码 全 部 都 保存 在 tvtk_classes.zip 文 件 中 。 而 tvtk 对 象 的 类 在 此 压缩 


文件 里 的 tvtk_helper.py 中 定义 。 对 于 TVTK 中 的 每 个 类 ，tvtk 对 象 都 有 一 个 同名 的 属 
性 和 类 相对 应 。 
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Mayavi- 更 方便 的 可 视 化 


虽然 VTK 3D 可 视 化 软件 包 功 能 强大 ，Python 的 TVTK 包 装 方便 简洁 ， 但 是 要 用 这 些 
工具 快速 编写 实用 的 三 维 可 视 化 程序 仍然 需要 花费 不 少 的 精力 。 因 此 基于 VTK 开 发 
了 许多 可 视 化 软件 ， 例 如 : ParaView、 VTKDesigner2、Mayavi2 等 等 。 


Mayavi2 完 全 用 Python 编写 ， 因 此 它 不 但 是 一 个 方便 实用 的 可 视 化 软件 ， 而 且 可 以 
方便 地 用 Python 编写 扩展 ， 佬 人 到 用 户 编 写 的 Python 程序 中 ， 或 者 直接 使 用 其 面向 
脚本 的 API : mlab 快 速 绘制 三 维 图 。 


用 mlab 快 速 绘图 


和 Chaco 的 shell 或 者 matplotlib 的 pylab 一 样 ，mayavi 的 mlab 模 块 提供 了 方便 快捷 的 
绘制 三 维 图 函数 。 只 要 把 数据 准备 好 ， 通 常 只 需要 调用 一 次 mlab 的 范 数 就 可 以 看 到 
数据 的 三 维 显示 效果 。 非 常 适合 在 IPython 中 交互 式 地 使 用 。 下 面 让 我 们 来 看 一 个 例 
子 : 


import numpy as np 
from enthought.mayavi import mlab 


X, y = np.ogrid[-2:2:20j, -2:2:20j] 
z= Xx * np.exp( = x**2 = y**2) 


pl = mlab.surf(x, y, z, warp_scale="auto") 
mlab.axes(xlabel='x', ylabel='y', zlabel='z') 
mlab.outline(pl) 





使 用 Mayavi 将 二 维 数组 绘制 成 3D 曲 面 
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我 们 先 用 下 面 的 语句 载 入 mlab 库 : 


from enthought.mayavi import mlab 


然后 通过 调用 mlab.surf 绘 制 一 个 三 维 空 间 中 的 曲面 。 曲 面 上 的 每 个 点 的 坐标 由 surf 
函数 的 三 个 二 维 数组 参数 x,y,z 给 出 。 由 于 数组 x,y 是 由 ogrid 对 象 算 出 ， 它 们 分 别 是 
shape 为 n1 和 人 n 的 数组 ， 而 Zz 是 一 个 n*n 的 数组 。 


通过 调用 mlab.axes 和 mlab.outline 辑 数 ， 分 别 在 三 维 空间 中 添加 坐标 轴 ， 和 曲面 区 
域 的 外 框 。 


surf 绘 制 的 曲面 在 X-Y 平 面 上 的 投影 是 一 个 等 距离 的 网 格 ， 如 果 需 要 绘制 更 复杂 的 三 
维 曲 面 的 话 ， 可 以 使 用 mesh 函 数 。 下 面 是 mesh 函 数 的 一 个 例子 : 


# -*- coding: utf-8 -*- 
from numpy import * 
from enthought.mayavi import mlab 


# Create the data. 

dphi, dtheta = pi/20.0, pi/20.0 

[phi, theta] = mgrid[0:pit+dphi*1.5:dphi,0:2*pitdtheta*1.5:dtheta] 
mO = 4; mi = 3; m2 = 2; m3 = 3; m4 = 6; m5 = 2; m6 = 6; m7 = 4; 

r sin(mO*phi)**m1 + cos(m2*phi)**m3 + sin(m4*theta)**m5 + cos(m6’ 


x = r*sin(phi)*cos(theta) 
y = r*cos(phi) 

z = r*sin(phi)*sin(theta) 
# View it. 


s = mlab.mesh(x, y, z, representation="wireframe", line _width=1.0 ` 
mlab.show( ) 
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使 用 mesh 画 数 绘制 的 3D 旋 转 体 


mesh 和 surf 类 似 ， 其 三 个 数组 参数 x, y, z 也 是 二 维 数 组 ， 他 们 相同 下 标的 三 个 元 素 
组 成 曲面 上 某 点 的 三 维 坐 标 。 点 之 间 的 连接 关系 ( 边 和 面 ) 由 其 在 x,y,z 数 组 中 间 的 位 
置 关系 决定 。 


由 于 这 个 程序 所 计算 的 曲面 是 一 个 旋转 体 ， 曲 面 上 的 各 个 点 的 坐标 是 在 球面 坐标 系 
中 计算 的 ， 然 后 按照 坐标 转换 公式 将 球面 坐标 转换 为 X-Y-Z 坐 标 。 


通过 传递 一 个 关键 字 参 数 representation 给 mesh 画 数 ， 可 以 指定 绘制 的 表现 形式 : 
e surface: 缺 省 值 ， 绘 制 曲面 
e wireframe : 绘制 边线 ， 将 dphi, dtheta 的 改 为 较 大 值 ， 例 如 pi/20 之 后 ， 调 用 : 


s = mlab.mesh(x, y, z, representation="wireframe", line_width=1 
| 
得 到 如 下 结果 : 
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使 用 mesh 画 数 绘制 的 线 框 模型 


为 了 方便 理解 mesh 画 数 是 如 何 绘 制 出 曲面 的 ， 我 们 通过 手工 输入 坐标 的 方式 ， 绘 
制 如 下 图 所 示 的 立方 体 表面 的 一 部 分 : 





组 成 立方 体 的 各 个 面 和 顶点 坐标 
x,y,z 数 组 的 定义 如 下 : 
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m~ x 
e Il 
He m~ 
He 1 
1 
Le 
KB 
a 
LE 


EI 
eee 17] 


z= [[1,1,-1,-1,1], 
[apa] 


X, y, Zz 数 组 对 应 坐标 的 元 素 组 成 三 维 坐标 点 ， 因 此 这 三 个 数组 实际 描述 的 坐标 点 
Al 


LE -1, 1; (1, a i) (1, -1, ab) (ar -1, =), Car -1, d 
KEA 1, Aly (1, 1, 1), (1, 1, D Ga 1, D (Ca 1, 1)] 





点 之 间 的 关系 有 其 在 数组 中 的 下 标 决定 ， 因 此 由 : 


(aly Sai) (al aay ay al, ag al) aly al al) 


构成 一 个 mesh 中 的 一 个 面 。 依 次 类 推 ， 第 二 个 面 由 : 


(irmi Ly (T= Ay (= 


构成 ， 一 共 定 义 有 4 个 面 。 
下 面 详 细 介 绍 mlab 中 提供 的 绘图 函数 。 
e points3d, plot3d : 给 它们 传递 的 3 个 坐标 数组 x,yz 都 是 一 维 的 ， 因 此 这 两 个 画 


数 绘制 出 来 的 是 三 维 空间 中 的 一 系列 点 (points3d)， 或 者 是 一 条 曲线 (plot3d)。 
下 图 是 采用 plot3d 绘 制 的 洛 仓 冀 吸 引子 的 轨迹 : 
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plot3d 画 数 绘 制 的 洛 仑 益 吸 引子， 曲线 使 用 很 细 的 圆 管 绘制 
绘图 语句 的 程序 如 下 : 


mlab.plot3d(tracki[:,9], tracki[:,1], tracki[:,2],color=(1,0,0), ti 
| = Ee 


其 中 track1 为 轨迹 坐标 数组 ， 将 其 拆 分 为 X,YZ 轴 的 三 个 分 量 之 后 ， 传 递 给 plot3d 画 
数 进 行 绘图 。tube_radius 指 定 曲 线 的 粗细 ， 曲 线 实 际 上 是 采用 极 细 的 圆 管 绘制 的 。 


洛 仑 益 吸 引子 的 轨迹 算法 请 参照 : SciPy- 数 值 计算 库 


e imshow, surf, contour_surf : 这 三 个 函数 都 可 以 接收 一 个 二 维 数组 sS， 以 其 第 
一 轴 的 下 标 为 X 轴 坐标 ， 第 二 轴 的 下 标 为 Y 轴 坐标 。imshow 本 数 将 此 二 维 数组 
当 作 一 个 图 片 显示 ， 每 点 的 颜色 为 数组 $ 的 每 个 元 素 的 值 。surf 函 数 则 将 此 二 维 
数组 绘制 成 三 维 空间 中 的 曲面 ， 数 组 中 每 个 元 素 的 值 为 点 的 Z 轴 坐标 。 
contour_surf 则 绘制 二 维 数 组 的 等 高 线 。 下 面 是 imshow 画 数 的 绘制 结果 (所 使 用 
的 数组 和 前 面 surf 函 数 的 例子 相同 ) : 
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imshow 本 数 将 二 维 数组 绘制 成 图 像 
同样 的 数据 采用 contour_surf 范 数 绘制 等 高 线 的 结果 如 下 图 所 示 : 





contour_surf 范 数 绘制 二 维 图 像 的 等 高 线 


Mayavi 应 用 程序 
将 Mayavi 散 入 到 界面 中 


Mayavi 除 了 能 够 单独 作为 应 用 程序 使 用 之 外 ， 也 可 以 通过 traits 属 性 误 人 到 TraitsUl 
制作 的 用 户 应 用 程序 的 界面 中 去 ， 下 面 的 程序 演示 了 这 一 过 程 : 
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# -*- coding: utf-8 -*- 

from enthought.traits.api import * 

from enthought.traits.ui.api import * 

from enthought.tvtk.pyface.scene_editor import SceneEditor 

from enthought.mayavi.tools.mlab_scene_model import MlabSceneModel 
from enthought.mayavi.core.ui.mayavi_scene import MayaviScene 


class DemoApp(HasTraits): 
plotbutton = Button(u" ø") 
scene = Instance(MlabSceneModel, ()) # mayavi 场 景 


view = View( 
VGroup( 

Item(name='scene', 
editor=SceneEditor(scene_class=MayaviScene), # 设置 
resizable=True, 
height=250, 
width=400 


Vy 
"plotbutton', 
show_labels=False 


), 

title=u"7ETrait sUIFfeAMayavi" 
def _plotbutton_fired(self): 

self.plot() 


def plot(self): 
g = self.scene.mlab.test_mesh() 


app = DemoApp() 
app.configure_traits() 


B] EEE 


程序 一 开始 除了 从 traits 和 traits.ui 库 导入 之 外 ， 还 分 别 从 不 同 的 地 方 导入 了 
SceneEditor、MlabSceneModel 和 MayaviScene 等 三 个 类 。 


MlabSceneModel 类 是 包装 整个 mlab 的 场景 的 模型 ， 它 是 属于 模型 (Model) 方 面 的 未 
西 ， 因 此 程序 中 通过 : 





scene = Instance(MlabSceneModel, ()) 


创建 一 个 traits 属 性 scene， 使 它 是 MlabSceneModel 类 的 对 象 。 接 下 来 要 在 视图 
(View) 中 创建 一 个 编辑 器 ， 让 它 正 确 显 示 scene 所 代表 的 模型 : 
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Item(name='scene', 
editor=SceneEditor(scene_class=MayaviScene), # 设置 mayavi 的 编辑 器 
resizable=True, 
height=250, 
width=400 
) 


RR 
SceneEditor 是 用 来 创建 场景 编辑 器 的 工厂 类 ， 通 过 关键 字 scene_class 指 定 真正 创 
建 场景 对 象 类 MayaviScene。 


程序 中 我 们 还 创建 了 一 个 plotbutton 按 钮 ， 当 此 按钮 被 按 下 时 ， 调 用 
_Pplotbutton_fired 画 数 ， 从 而 调用 最 后 的 绘制 场景 的 范 数 plot，plot 辑 数 只 有 一 名 
话 : 


g = self.scene.mlab.test_mesh() 
scene.mlab#l AU MATT 24 Wmlab# — 78, il ARtest_meshimixBRX, i 
速 在 scene 中 创建 一 个 如 下 图 所 示 的 很 酷 的 曲面 体 。 


fe TE TraitsURPiRA Mayavi -olxl 
> |e ez be 


\ 





将 Mayavi 氏 入 到 TraitsUl 制 作 的 界面 中 


下 面 让 我 们 来 看 一 个 有 些 实用 价值 的 程序 ， 用 户 输入 一 个 使 用 x,y,z 等 变量 的 函数 
f(x,y,z)， 例 如 xx+yy+z*z， 程 序 将 使 用 此 函数 计算 一 个 指定 坐标 范围 之 内 的 三 维 标 
量 场 。 并 且 添 加 等 值 面 和 切面 两 个 工具 观察 此 标量 场 。 等 值 面 可 以 是 自动 计算 ， 或 
者 通过 滚动 条 手工 配置 ; 而 切面 的 位 置 和 方向 则 可 以 直接 在 场景 中 用 鼠标 进行 操 
作 。 完 整 的 程序 请 参考 三 维 标量 场 观 察 器 ， 下 面 对 程 序 中 的 重点 部 分 进行 说 明 。 
用 户 点 击 描绘 按钮 之 后 ， 调 用 plot 函 数 绘图 ，plot 画 数 中 首先 计算 三 维 标量 场 ， 注 意 


我 们 使 用 mgrid 快 速 产生 三 维 网 格 ，x0, x1, yO, y1, z0, z1, points, function 等 都 是 
traits 属 性 ， 可 以 通过 界面 直接 修改 其 值 : 
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# 产生 三 维 网 格 
x, y, Zz = mgrid[ 
self .x0:self.x1:1j*self.points, 
self .yO:self.y1:1j*self.points, 
self .z0:self.z1:1j*self.points] 
scalars = eval(self.function) # 根据 画 数 计算 标量 场 的 值 


然后 清空 当前 的 场景 : 


self.scene.mlab.clf() # 清空 当前 场景 


接 下 来 调用 scene.mlab 中 的 axes, contour3d, pipeline.scalar_cut_plane 等 函数 在 场 
景 中 添加 等 值 面 、 坐 标 轴 和 切面 : 


# 绘制 等 值 面 

g = self.scene.mlab.contour3d(x, y, z, scalars, contours=8, transpé 
g.contour.auto_contours = self.autocontour 

self.scene.mlab.axes() # 添加 坐标 轴 


# 添加 一 个 X-Y 的 切面 
s = self.scene.mlab.pipeline.scalar_cut_plane(g) 
cutpoint = (self.xO0+self.x1)/2, (self.yO0+self.y1)/2, (self.z0+self 
s.implicit_plane.normal (0,0,1) # x cut 
s.implicit_plane.origin cutpoint 


H 一 —g 


后 更 新 几 个 属性 ， 其 中 v0 和 v1 是 标量 场 的 最 小 和 最 大 值 ， 用 来 设置 等 值 面 滚动 条 
的 取 值 范 围 : 





self.g =g 

self.scalars = scalars 

# 计算 标量 场 的 值 的 范围 

self .vO np.min(scalars) 
self.vi = np.max(scalars) 


当 界 面 中 的 “自动 等 值 "选项 值 (autocontour 属 性 ) 改 变 时 ， 通 过 调用 如 下 程序 改变 场 
景 中 的 等 值 面 的 自动 选项 : 


self.g.contour.auto_contours = self.autocontour 


当 界 面 中 的 滚动 条 值 (contour 属 性 ) 发 生变 化 时 ， 通 过 下 面 的 程序 修改 场景 中 等 值 面 
的 值 : 
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if not self.g.contour.auto_contours: 
self.g.contour.contours = [self.contour ] 


剩 下 的 部 分 都 是 使 用 标准 的 traits 和 TraitsUl 库 编写 的 ， 请 参考 TraitsUI- 轻 松 制作 用 户 
界面 ， 这 里 就 不 再 多 解释 了 。 


此 程序 的 界面 截图 如 下 图 所 示 : 


s 三 锥 标量 场 观察 器 二 | 口 | 
ws | el te) fe) eZ) s mk al | bel KS 
> | 
5 | 
wi:[5 | 
z:[5 | 
x7 

点 数 : [50 
自动 等 值 : Yr 





x*y*0.5 + sin(2*x)*y + y*z*2.0 


4.92 ' ' ' ' ' i ' ' ' J ' 64.92 0.50 


三 维 标 量 场 观察 器 : x*y*0.5+2*y*sin(2*x)+y*z*2.0 
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Visual- 制 作 3D 演 示 动 男 


Visual 是 Python 的 一 个 简单 易 用 的 3D 图 形 库 ， 使 用 它 可 以 快速 创建 3D 场 景 、 动 
画 。 和 TVTK 相 比 它 更 加 适合 于 创建 交互 式 的 3D 场 景 ， 而 TVTK 则 更 加 适合 于 数据 的 
3D 图 形 化 显示 。 在 本 节 中 将 通过 一 个 实例 简单 的 介绍 如 何 使 用 Visual 制 作 3D 动 画 。 


场景 、 物 体 和 照相 机 
先 来 看 一 个 最 简单 的 例子 : 


from visual import * 
box() 


这 个 程序 的 运行 结果 如 下 图 的 左 图 所 示 : 
10 x! 10) x! 





用 鼠标 旋转 之 后 ， 可 以 看 出 VPython 绘 制 的 立方 体 


我 们 先 从 visual 库 中 载 入 所 有 对 象 ， 然 后 通过 box() 创 建 一 个 box 类 的 实例 ， 创 建 这 
个 实例 的 同时 将 产生 一 标题 为 VPython 的 场景 窗口 。 由 于 我 们 没有 给 box 传 递 参数 ， 
所 创建 的 立方 体 的 所 有 属性 都 是 缺 省 配置 : 

。 立方 体 的 3D 空 间 的 坐标 为 0, 0, 0， 即 坐标 原点 


立方 体 的 大 小 为 1, 1, 1 
。 立方 体 的 颜色 为 日 色 


而 场景 中 的 照相 机 缺 省 从 Z 轴 的 上 方 往 下 看 (俯视 图 ) ， 缩 放 上 比例 缺 省 是 正好 显示 
场景 中 的 所 有 物体 。 于 是 我 们 在 场景 中 看 到 的 是 一 个 刚好 充满 场景 窗口 的 正方 形 。 


照相 机 
照相 机 实际 上 就 是 我 们 观察 3D 场 景 的 工具 ， 我 们 通过 照相 机 观察 场景 中 的 物体 ， 照 


相机 本 身 在 场景 中 是 不 可 见 的 。 缩 放 比 例 和 旋转 场景 其 实 都 是 对 照相 机 进行 操作 ， 
进行 这 些 操作 时 ， 场 景 中 的 物体 并 没有 改变 ， 只 是 我 们 观察 物体 的 方位 改变 了 。 


在 场景 窗口 中 ， 同 时 按 住 鼠 标 左右 按键 ， 上 下 移动 鼠标 可 以 进行 缩放 场景 ; RE 
标 右键 移动 鼠标 可 以 旋转 场景 。 右 图 是 进行 适当 的 旋转 和 缩放 之 后 的 效果 。 我 们 看 
到 box() 确 实 是 创建 了 一 个 立方 体 。 


为 了 搞 清楚 照相 机 的 位 置 和 坐标 轴 之 间 的 关系 ， 让 我 们 运行 下 面 这 个 小 程序 : 


# -*- coding: utf-8 -*- 

from visual import * 

display(title=u"4i745".encode("gb2312"), width=300, height=300) 
arrow(pos=(1,0,0), axis=(1,0,0), color=(1,0,0)) 
arrow(pos=(0,1,0), axis=(0,1,0), color=(0,1,0)) 
arrow(pos=(0,0,1), axis=(0,0,1), color=(0,0,1)) 


CE x! 





VPython 照 相机 的 缺 省 位 置 ， 红 绿 蓝 分 别 表 示 X,Y,Z 轴 


这 段 程序 中 ， 我 们 通过 调用 display() 创 建 一 个 场景 窗口 ， 并 且 指 定 了 窗口 的 标题 、 
宽度 和 高 度 。 标 题 必须 使 用 Windows 系 统 缺 省 的 编码 ， 因 此 为 了 显示 中 文 ， 需 要 将 
unicode 转换 为 gb2312 编 码 。 


调用 3 次 arrow() 创 建 了 三 个 箭头 物体 ， 我 们 通过 几 个 关键 字 参 数 配置 箭头 的 属性 : 


。 箭头 的 起 点 坐标 用 pos 关 键 字 参 数 指 定 ， 分 别 为 (1,0,0), (0,1,0), (0,0,1), H47 
3 元 组 元 表示 。 这 三 个 坐标 都 在 坐标 轴 上 。 

e。 箭头 的 方向 和 长 度 使 用 axis 关 键 字 参 数 指定 ， 其 值 为 3D 空 间 的 矢量 ， 矢 量 也 是 
用 三 元 组 元 表示 ， 程 序 中 所 用 的 三 个 矢量 正好 是 三 个 坐标 轴 的 方向 ， 长 度 为 
ls 

。 通过 color 参 数 指定 箭头 物体 的 颜色 ， 颜 色 也 是 用 三 元 组 元 表示 ， 取 值 范围 为 0 
到 1， 分 别 表 示 红 、 绿 、 蓝 三 色 的 成 分 。 


过 观察 图 中 的 三 个 箭头 的 位 置 ， 我 们 可 以 知道 : 


e 窗口 的 中 心 为 坐标 原点 
e xe AMARA 
e y 轴 为 从 下 到 上 


。 Zz 轴 为 从 屏幕 里 到 屏幕 外 
因此 此 时 的 照相 机 位 于 z 轴 正方 向 上 的 某 点 ， 方 向 治 着 z 轴 负 方 向 俯视 。 


简单 动力 
下 面 让 我 们 来 看 看 如 何 用 visual 创 建 一 个 简单 的 3D 动 画 ， 先 看 一 下 完整 的 程序 : 


# -*- coding: utf-8 -*- 
from visual import * 


display(title=u" 4 %4" .encode("gb2312"), width=500, height=300) 


ball = sphere(pos=(-5,0,0), radius=0.5, color=color.red) 
wall_right = box(pos=(6,0,9), size=(0.1, 4, 4), color=color.green) 
wall left = box(pos=(-6,0,0), size=(0.1, 4, 4), color=color.green. 


dt = 0.05 
ball.velocity = vector(6, 0, 0) 


while True: 
rate(1/dt) 
ball.pos = ball.pos + ball.velocity*dt 
if ball.x > wall_right.x-ball.radius or ball.x < wall left.x+be 
ball.velocity.x *= -1 
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球 在 板子 之 间 反 复 运 动 的 简单 动画 


运行 这 段 程序 会 出 现 一 个 有 两 块 绿 色 板 子 和 一 个 红 球 的 窗口 ， 红 球 在 两 块 板子 之 间 
反复 运动 。 


第 6-8 行 创建 了 场景 中 的 三 个 物体 : 两 块 绿 色 的 板子 (box) 和 一 个 红色 的 球 
(sphere)。sphere 可 以 通过 radius 属 性 设置 其 半径 ， 而 box 可 以 通过 size 属 性 设置 其 
X, y, z 轴 方向 的 长 度 。 前 面 提 到 过 axis 属 性 也 可 以 改变 box 的 大 小 ， 这 两 个 属性 是 互 
相 影 响 的 ， 在 用 户 手 册 中 我 们 会 详细 讨论 这 个 问题 。 


第 10 行 定义 了 一 个 变量 dt， 我 们 用 它 来 表示 动画 中 每 帧 之 间 的 时 间 间 隔 。 第 11 行 我 
们 给 ball 添 加 一 个 velocity 属 性 ， 它 是 一 个 3D 矢 量 表示 球体 的 速度 。 请 注意 velocity 
不 是 sphere 类 固有 的 属性 ， 是 我 们 为 ball 物 体 动态 添加 的 属性 。 


第 13 行 开始 一 个 死 循 环 ， 在 这 个 循环 中 不 断 地 更 新 ball 的 pos 属 性 以 实现 动画 效果 ， 
为 了 控制 动画 的 播放 速度 ， 在 循环 中 先 调用 rate 函 数 。 由 于 dt 为 0.05 秒 ， 因 此 我 们 
动 男 速度 为 每 秒 20 帧 。rate 汞 数 会 让 程序 等 待 足 够 长 的 时 间 使 得 动画 播放 的 帧 数 接 
近 指 定 的 帧 数 。 


第 15 行 修改 ball 的 pos 属 性 ， 加 上 在 dt 时 间 段 中 ball 的 位 移 量 。 第 16, 17 行 处 理 和 板 
子 的 碰撞 ， 因 为 pos 为 球 的 中 心 坐标 ， 而 碰撞 点 在 球 的 表面 ， 因 此 久 理 碰撞 时 还 需 
要 考虑 球 的 半径 。 确 定 碰撞 之 后 ， 只 需要 将 球 的 速度 反 转 即 可 。 


由 于 球 的 速度 为 6， 而 两 板 之 间 的 间 隅 为 12， 因 此 球 从 左 板 移动 到 右 板 需要 2 秒 钟 时 
间 。 


盒子 中 反弹 的 球 


下 面 让 我 们 来 看 一 个 完整 的 反弹 动画 程序 。 在 场景 中 放置 6 个 半 透 明 的 墙 面 ， 形 成 
一 个 正方 体 ， 球 体 的 在 正方 体内 部 运动 反弹 ， 我 们 可 以 调整 重力 加 速度 (Z 方 向 的 加 
速度 ) 和 反弹 系数 ， 同 时 还 显示 球 的 速度 矢量 和 运动 轨迹 。 下 面 是 完整 的 程序 : 


# -*- coding: utf-8 -*- 
from visual import * 


display(title=u" 4 #%#i".encode("gb2312"), width=500, height=500) 
# 创建 球体 和 6 个 墙 面 ， 墙 面 设置 为 半 透 明 ， 以 观察 球体 的 运动 轨迹 


ball = sphere(pos=(-5,0,0), radius=0.5, color=color.red) 
wall_ right = box(pos=(6,0,0), size=(0.1, 12, 12), color=color.greer 


wall _ left = box(pos=(-6,0,0), size=(0.1, 12, 12), color=color.gree 
wall_ front = box(pos=(0,-6,0), size=(12, 0.1, 12), color=color.gree 
wall back = box(pos=(0,6,0), size=(12, 0.1, 12), color=color.greer 
wall _ bottom = box(pos=(0,0,-6), size=(12, 12, 0.1), color=color.gre 
wall_top = box(pos=(0,0,6), size=(12, 12, 0.1), color=color.greer 
dt = 0.05 

g = 9.8 # 重力 加 速度 

f = 0.9 # 反弹 能 量 保持 系数 ，1 .0 表示 完全 反弹 

ball.velocity = vector(8, 6, 12) 


bv = arrow(pos = ball.pos, axis=ball.velocity*0.2, color=color.yel- 
ball.trail = curve(color=ball.color) 
trail_color = 0 # 轨迹 的 颜色 


while True: 


rate(1/dt) 


# 重力 加 速度 改变 z 轴 方向 的 速度 ， 不 存在 反弹 时 修改 速度 
ball.velocity.z -= g * dt 


# 根据 速度 修改 球体 的 位 置 
ball.pos += ball.velocity * dt 


## JRE A IER FURIE DA, REY AY TUB A TTB 

## 处 理 反 弹 时 需要 修正 球 的 位 置 ， 使 它 正好 和 墙 面 接触 

# 处 理 左右 墙 的 反弹 

if ball.velocity.x > © and ball.x >= wall_right.x - ball.radiu: 
ball.x = wall_right.x - ball.radius 
ball.velocity.x *= -f 

if ball.velocity.x < 0 and ball.x <= wall_left.x + ball.radius 
ball.x = wall_left.x + ball.radius 
ball.velocity.x *= -f 


# 处 理 前 后 墙 的 反弹 

if ball.velocity.y > 0 and ball.y >= wall_back.y - ball.radius 
ball.y = wall_back.y - ball.radius 
ball.velocity.y *= -f 

if ball.velocity.y < © and ball.y <= wall_front.y + ball.radius 
ball.y = wall_front.y + ball.radius 
ball.velocity.y *= -f 


# 处 理 上 下 墙 的 反弹 

if ball.velocity.z > 0 and ball.z >= wall_top.z - ball.radius: 
ball.z = wall_top.z - ball.radius 
ball.velocity.z *= -f 

elif ball.velocity.z < 0 and ball.z <= wall_bottom.z + ball.rac 
ball.z = wall_bottom.z + ball.radius 
ball.velocity.z *= -f 


# 更 新 速度 箭头 的 位 置 和 方向 

bv.pos = ball.pos 

bv.axis = ball.velocity*0.2 

# 添加 球 的 轨迹 点 

ball.trail.append( pos = ball.pos, color = (trail_color, 0, 0). 
trail_color += 1.0/30.0*dt # 30 秒 后 颜色 变 为 全 红 

if trail_color > 1.0: trail_color = 1.0 


SS 








球 在 封闭 的 盒子 中 反弹 的 动画 


第 8-13 行 创建 上 下 左右 前 后 六 个 墙 面 ， 通 过 设置 其 opacity 属 性 ， 设 置 其 不 透明 度 为 
0.2。opacity=0.0 表 示 完 全 透明 ，opacity=1.0 表 示 完 全 不 透明 。 


第 19 行 用 arrow() 创 建 了 一 个 箭头 物体 ， 它 的 起 始点 位 置 为 球体 的 中 心 ， 方 向 和 球体 
的 速度 方向 相同 : 


bv = arrow(pos = ball.pos, axis=ball.velocity*®.1, color=color.yel- 





第 20 行 用 cureve() 创 建 一 个 曲线 物体 ， 并 赋值 给 球体 的 trail 属 性 : 


ball.trail = curve(color=ball.color) 


第 27 行 使 用 加 速度 更 新 球体 的 速度 ， 第 30 行 使 用 速度 更 新 球 的 体位 移 。 


第 35-56 行 ， 义 理 球体 和 墙壁 的 碰撞 ，x, y, z 三 个 方向 的 碰撞 处 理 方式 相同 ， 这 里 以 
Xx 方向 为 例 简要 说 明 一 下 磁 撞 人 处理。 


当 球体 的 x 轴 方向 的 速度 为 正 时 ， 判 断 球体 是 否 和 正方 向 的 墙壁 ( 右 墙 ) 相 撞 ， 如 果 相 
撞 的 话 则 将 其 x 抽 方向 的 速度 反 向 ， 并 且 乘 以 磁 撞 系数 模拟 能 量 损 失 ， 同 时 修改 球 
体 的 x 轴 坐标 ， 使 得 其 正好 和 右 墙 相 接触 。 球 体 的 x 轴 方向 速度 为 负 时 ， 和 左 墙 进行 
碰撞 检测 : 


if ball.velocity.x > 0 and ball.x >= wall_right.x - ball.radius: 
ball.x = wall_right.x - ball.radius 
ball.velocity.x *= -f 

if ball.velocity.x < 0 and ball.x <= wall_left.x + ball.radius: 
ball.x = wall_left.x + ball.radius 
ball.velocity.x *= -f 


第 59,60 行 更 新 箭头 物体 的 位 置 和 方向 以 表示 球体 的 速度 。 第 624 村 将 现在 的 球体 的 
位 置 添 加 进 球 体 的 轨迹 曲线 物体 。 第 63,64 行 更 新 轨迹 的 颜色 ， 这 样 颜色 按照 随 着 
时 间 逐 渐变 红 ， 从 黑 变 红 一 共 需 要 30 秒 时 间 。 


OpenCV- 图 像 处 理 和 计算 机 视觉 


OpenCV 是 Intel 公 司 开发 的 开源 计算 机 视觉 库 。 它 用 C 语 言 高 速 地 实现 了 许多 图 像 
处 理 和 计算 机 视觉 方面 的 通用 算法 ， 并 且 通 过 SWIG 提 供 了 Python 的 调用 接口 。 本 
章 介 绍 用 Python 调用 OpenCV 库 ， 实 现 一 些 简单 的 图 像 处 理 和 计算 机 视觉 算法 。 


OpenCV 提 供 的 Python 调用 接口 和 C 语 言 的 API 基 本 上 是 一 致 的 ， 这 个 接口 对 于 动态 
语言 Python 来 说 有 些 黑 浆 。 不 过 由 于 Python 程序 和 C 语 言 程序 差别 不 大 ， 用 Python 
调用 OpenCV， 能 够 帮助 我 们 测试 API 范 数 和 快速 实现 算法 。 


` rea ~ 
读 写 图 像 和 视频 文件 
让 我 们 从 显示 一 幅 图 像 开 始 进入 OpenCV : 
# -*- coding: utf-8 -*- 
from opencv.highgui import * 
import sys 
img = cvLoadImage( sys.argv[1] ) 
cvNamedWindow("Examplei", CV_WINDOW_AUTOSIZE) 


cvShowImage("Examplei", img) 
cvwWaitKey(0) 


OpenCV 的 库 可 以 分 为 5 个 主要 组 成 部 分 ， 下 图 显示 了 其 中 的 4 个 : 


cv MLL HighGUI 


Image processing Statistical Classifiers GUI, 
an and Image and 
Vision Algorithms Clustering Tools Video I/O 


CXCORE 


basic structures and algorithms, 
XML support, drawing functions 





OpenCV 的 5 个 主要 组 成 部 分 


e CV: 包括 了 基本 的 图 像 处 理 和 高 级 的 计算 机 视觉 算法 ， 在 Python 中 ， 
opencv.cv 模 块 与 之 对 应 

eo ML: 机 器 学 习 库 ， 包 括 许多 统计 分 类 器 ，opencv.ml 模 块 与 之 对 应 

。 HighGUI : 提供 各 种 图 像 、 视 频 、 数 据 的 输入 输出 和 简单 的 GUI 开 发 ， 


opencv.highgui 模 块 与 之 对 应 

e CXCore : 上 述 三 个 库 都 是 以 CXCore 提 供 的 基本 数据 结构 和 男 数 为 基础 ， 主 模 
块 OpencVv 和 与 之 对 应 

e CvAux: 包括 一 些 实验 性 的 算法 


显示 图 像 的 例子 中 ， 只 用 到 数据 输入 和 界面 显示 两 个 功能 ， 他 们 都 在 highgui 库 中 ， 
因此 需要 从 库 中 载 入 这 些 加 数 ， 由 于 opencv 的 所 有 API 画 数 都 以 cv 开头 ， 因 此 不 怕 
他 们 和 别 的 库 命名 冲突 : 


from opencv.highgui import * 


下 面 调用 cvLoadlImage 从 文件 中 读 入 图 片 信息 ， 其 返回 的 是 一 个 opencv.cv.cvMat 对 
象 ，cvMat 是 OpenCV 中 描述 矩阵 (或 者 说 多 维 数组 ) 的 数据 结构 ， 许 多 图 像 处 理 操作 
都 是 针对 cvMat 对 象 进行 的 : 


img = cvLoadImage( sys.argv[1] ) 


下 面 调用 cvVNamedWindow 函 数 创建 一 个 窗口 ， 其 名 字 为 "Example1"， 大 小 设置 
CV_WINDOW_AUTOSIZE， 表 示 它 随 着 其 内 容 自 动 改变 大 小 : 


cvNamedWindow("Example1", CV_WINDOW AUTOSIZE) 


然后 调用 cvShowlmage 男 数 ， 将 img 表 示 的 图 像 蛙 示 在 "Example1" 窗 口 。 由 于 
OpenCV 库 大 部 分 代码 都 是 使 用 C 语 言 纺 编写 的 ， 因 此 它 采 用 “对 象 .方法 ("的 方式 ， 而 
是 使 用 函数 的 方式 。 而 且 highgui 提 供 的 久 是 简便 的 GUI 功能 ， 因 此 这 里 直接 用 字符 
串 "Example1" 表 示 要 显示 图 片 的 窗口 ， 而 不 是 用 某 个 表示 窗口 的 对 象 。 


最 后 调用 cvWaitKey， 等 竺 用 户 按键 输入 ， 如 果 其 参数 为 正 值 ， 那 么 等 待 指定 的 宫 
秒 数 后 继续 运行 ; 如 果 其 值 为 0， 表 示 永 久 等 待 : 


cvWaitKey(0) 


如 果 在 IPython 中 运行 上 面 程序 之 后 ，IPython 等 待 用 户 按键 输 入 ， 按 任意 键 之 后 ， 

IPython 进 入 可 输入 命令 的 状态 ， 并 且 显 示 图 片 的 窗口 并 没有 关闭 ， 这 样 就 可 以 在 
IPython 中 直接 输入 opencv 的 函数 调用 ， 坦 看 其 结果 。 下 面 的 先 从 opencv.cv 载 人 所 
有 图 像 处 理 相关 的 函数 ， 


>>> from opencv.cv import * 


然后 调用 cvSmooth 画 数 对 img 进 行 高 斯 模糊 ，cvSmooth 画 数 的 第 一 个 参数 指定 原 
始 图 像 ， 第 二 个 参数 指定 输出 图 像 ， 这 里 都 用 img， 因 此 高 斯 模糊 的 结果 覆盖 原始 
图 像 ， 第 三 个 参数 指定 采用 高 斯 模糊 算法 ， 第 四 个 参数 是 高 斯 模糊 的 参数 : 以 像素 
点 为 单位 的 模糊 范围 : 
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>>> cvSmooth(img, img, CV_GAUSSIAN, 11) 


最 后 调用 cvShowlmage 更 新 窗口 中 的 图 片 : 


>>> cvShowImage("Examplei", img) 


下 面 是 图 像 处 理 的 结果 ， 左 图 为 原始 图 像 ， 











调用 cvSmooth 对 图 像 进行 高 斯 模糊 处 理 
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定义 Traits 
在 Python 程序 中 按照 下 面 的 步骤 使 用 Traits 库 : 


1. 从 enthought.traits.api 中 载 入 你 所 需要 的 对 象 
2. 定义 你 想 使 用 的 traits 
3. 从 HasTraits 类 继承 一 个 新 类 ， 在 其 中 使 用 你 定义 的 traits 声 明 trait 属 性 


通常 第 2、3 步 是 放 在 一 起 的 ， 也 就 是 说 定义 traits 的 同时 定义 trait 属 性 ， 在 本 手册 中 
的 大 部 分 例子 都 是 采用 这 种 方式 : 


from enthought.traits.api import HasTraits, Float 


class Person(HasTraits): 
weight = Float(50.0) 


这 段 程序 定义 了 一 个 从 HasTraits 类 继承 的 Person 类 ， 在 其 内 部 声明 了 一 个 名 为 
weight 的 trait 属 性 ， 其 类 型 为 浮 点 数 ， 初 始 值 为 50.0。trait 属 性 像 类 的 属性 一 样 定 
义 ， 像 实例 的 属性 一 样 使 用 。 下 面 我 们 来 看 看 如 何 使 用 trait 属 性 : 


>>> joe = Person() 
>>> joe.weight 
50.0 


>>> joe.weight = 70.5 
>>> joe.weight = 70 
>>> joe.weight = "89" 


Traceback (most recent call last): 

File "...trait_handlers.py", line 175, in error value ) 
TraitError: The 'weight' trait of a Person instance must be a float 
but a value of '89' <type 'str'> was specified. 





由 于 joe 是 Person 类 的 实例 ， 因 此 它 有 一 个 名 为 weight 的 trait 属 性 ， 并 且 初 始 值 为 
50.0。 由 于 weight 是 使 用 Float 声 明 的 ， 我 们 能 将 浮 点 数 赋值 给 它 ， 由 于 整数 可 以 不 
丢失 精度 的 转换 为 浮 点 数 ， 因 此 整数 也 可 以 赋值 给 它 。 然 而 ， 把 浮 点 数 赋 值 给 整数 
trait 属 性 将 会 产生 错误 。 由 于 字符 串 无 法 转换 为 浮 点 数 ， 因 此 赋值 为 字符 串 产 生 错 
误 ， 错 误 的 提示 信息 告诉 我 们 它 需 要 浮 点 数 。 

有 时 候 我 们 希望 trait 属 性 能 够 自动 的 进行 强制 类 型 转换 ， 这 样 我 们 就 可 以 将 字符 串 
赋值 给 类 型 为 float 的 trait 属 性 ， 省 去 了 手工 转换 的 麻烦 。 这 种 强制 类 型 转换 的 trait 属 
性 都 用 Casting trait 声 明 ， 所 有 的 Casting trait 都 是 以 C 开头 的 : 


from enthought.traits.api import HasTraits, CFloat 


class Person(HasTraits): 
cweight = CFloat(50.0) 


>>> bill = Person() 

>>> bill.cweight = "90" 

>>> bill.cweight 

90.0 

>>> bill.cweight = "abc" 
Traceback (most recent call last) 


这 段 程序 用 CFloat 声 明了 一 个 强制 类 型 转换 的 trait 属 性 cweight。 我 们 可 以 将 能 转换 
为 浮 点 数 的 字符 串 "90" 赋 值 给 它 ， 但 是 "abc" 这 样 的 字符 串 赋值 仍然 会 抛 出 异常 。 
我 们 可 以 想象 CFloat 的 内 部 处 理 : 它 先 将 传人 的 值 用 内 部 函数 float() 进 行 强制 类 型 
转换 ， 然 后 把 结果 赋值 给 trait 属 性 。 
我 们 也 可 以 先 单独 定义 一 个 traits， 然 后 用 它 来 声明 多 个 类 的 多 个 trait 属 性 ， 下 面 是 
一 个 例子 : 

from enthought.traits.api import HasTraits, Range 


coefficient = Range(-1.0, 1.0, 0.0) 


class quadratic(HasTraits): 


c2 = coefficient 
c1 = coefficient 
cO = coefficient 
x = Range(-100.0, 100.0, 0.0) 


在 这 个 例子 中 ， 我 们 需要 定义 多 个 trait 属 性 ， 其 类 型 都 为 Range( 具 有 取 值 范围 的 浮 
点 值 )， 并 且 范 围 都 是 -1.0 到 1.0， 初 始 值 为 0.0。 为 了 体现 代码 重用 ， 我 们 先 用 
coefficient = Range(-1.0, 1.0, 0.0) 定 义 了 一 个 traits， 然 后 在 quadratic 类 中 使 用 它 定 
义 三 个 trait 属 性 : c0, c1, c2。 


预定 义 的 Traits 


Traits 库 为 Python 的 许多 数据 类 型 提供 了 预定 义 的 trait 类 型 。HasTraits 派 生 的 类 中 
Dd 这 个 类 的 所 有 实例 都 将 拥有 一 个 初始 化 为 缺 省 值 的 
属性 ， 例 如 : 


class Person(HasTraits): 
age = Float 


上 面 的 例子 为 Person 类 定义 了 一 个 age 属性 ， 其 类 型 为 浮 点 数 ， 并 且 被 初始 化 为 
0.0(Float 的 缺 省 值 )。 如 果 你 希望 用 别 的 值 初始 化 trait 属 性 的 话 ， 可 以 把 这 个 值 当 作 
参数 传递 给 trait 类 型 : 


age = Float(10.0) 


几乎 所 有 的 trait 类 型 都 是 可 以 带 括号 调用 的 ， 它 可 以 接受 缺 省 值 或 者 其 它 的 参数 ; 
还 可 以 通过 关键 字 参 数 接受 元 数据 。 .. TODO:: 插入 元 数据 链接 


简单 类 型 
对 于 每 个 Python 的 简单 数据 类 型 都 对 应 两 种 trait 类 型 : 强制 类 型 和 自动 转换 类 型 。 
它们 的 区 别 在 于 : 


。 强制 型 Trait : 当 这 样 trait 属 性 被 赋值 为 类 型 不 匹配 的 数据 时 ， 会 产生 错误 
。 自动 型 Trait : 类 型 不 匹配 时 会 自动 调用 此 类 型 对 应 的 Pyton 内 置 的 转换 函数 进 
行 类 型 转换 


强制 型 自动 型 Python 对 应 的 数据 类 AERA E A) F 
Trait Trait 型 值 数 
Bool CBool Boolean False bool() 
Complex CComplex Complex number 0+0j complex() 
Float CFloat Floating pomt 0.0 float() 
number 
Int Cint Plain integer 0 int() 
Long CLong Long integer OL int() 
Str CStr String z str() 
Unicode CUnicode Unicode y“ unicode() 


下 面 的 例子 演示 了 强制 型 Trait 和 自动 型 Trait 之 间 的 区 别 : 


>>> from enthought.traits.api import HasTraits, Float, CFloat 
>>> Class Person ( HasTraits ): 
weight = Float 
ree Cweight = CFloat 
>>> bill = Person() 
>>> bill.weight = 180 # OK， 整 数 和 浮 点 数 匹 配 (转换 为 浮 点 数 而 不 丢失 信息 
>>> bill.cweight 180 # OK, 
>>> bill.weight # Error， 字 符 串 和 浮 点 数 不 匹 配 
>>> bill.cweight '180' # 0K， 调 用 float('180 ' ) 转 换 为 浮 点 
>>> print bill.cweight 
180.0 
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其 它 
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除了 简单 类 型 以 外 ，Traits 库 还 定义 了 许多 其 他 的 常用 的 数据 类 型 。 几 乎 所 有 的 
Trait 类 型 都 可 以 直接 使 用 其 名 称 或 者 当 作画 数 调用 ， 并 且 可 以 接受 多 种 参数 。 


。 Any : 任何 对 象 ; 


Array( [dtype = None, shape = None, value = None, typecode = Nc 





° O 通常 用 来 触发 事件 ， 参 数 都 是 用 来 摘 述 界面 中 的 按钮 的 样 
I, 


Callable( [value = None, **metadata] ) 


o CArray : 可 自动 转换 类 型 的 numpy 数 组 ; 调用 的 参数 和 Array 相 同 
o Class : Python 老式 类 ; 


Code( [value = "", minlen = 0, maxlen = sys.maxint, regex = "", 

o Color: 界面 库 中 所 采用 的 颜色 对 象 ; 

CSet( [trait = None, value = None, items = True, **metadata] ) 
cL 了 

o Constant: 常量 对 象 ， 其 值 不 能 改变 ， 必 须 指 定 初始 值 ; 

Dict( [key_trait = None, value_trait = None, value = None, iten 


‘ = 











o Directory: 表示 某 个 目录 的 路 径 的 字符 串 ; 


Either( vali*[, *val2, ..., valN, **metadata] ) 


o Enum: 枚 举 数据 ， 其 值 可 以 是 候选 值 中 的 一 个 ; 


Event( [trait = None, **metadata] ) 


o Expression : Python 的 表达 式 对 象 ; 

File( [value = "", filter = None, auto_set = False, entries = 1 
| = z 

o Font: 界面 库 中 表示 字体 的 对 象 ; 


class Employee(HasTraits): 
manager = self 





ELT —*Employee#, EGA—NmanagerBtt, HA#%Employee, RA 
值 为 对 象 本 身 : 


>>> e = Employee() 

>>> e.manager 

<__main__.Employee object at 0Ox05DB72A0> 
>>> e 

<__main__.Employee object at 0x05DB72A0> 


如 果 用 This 定 义 的 话 ， 那 么 缺 省 值 为 None。 
一 般 来 说 ， 属 性 为 某 个 类 的 实例 时 可 以 这 样 定义 : 

manager = Instance(Empolyee) 
但 是 对 于 这 个 例子 中 ， 在 定义 manager 属 性 时 ，Empolyee 还 不 存在 ， 因 此 无 法 
如 此 定义 。 如 果 你 喜欢 这 种 方式 的 话 ， 可 以 用 Instance("Empolyee") 来 定义 ， 
当 两 个 类 的 属性 交叉 引用 时 ， 可 以 使 用 这 种 字符 串 的 方式 来 定义 。 
This 和 self 不 但 可 以 表示 类 本 身 ， 还 可 以 表示 派生 的 类 : 


>>> from enthought.traits.api import HasTraits, This 
>>> class Employee(HasTraits): 
manager = This 


>>> class Executive(Employee): 
pass 


>>> fred = Employee() 
>>> mary = Executive() 
>>> fred.manager = mary 
>>> mary.manager = fred 


列 出 可 能 的 值 


使 用 Enum 可 以 定义 枚 举 类 型 ， 在 Enum 的 定义 中 给 出 所 有 可 能 的 值 ， 这 些 值 必 
须 是 Python 的 简单 数据 类 型 ， 例 如 字符 串 、 整 数 、 浮 点 数 等 等 ， 各 个 可 能 的 值 
的 类 型 可 以 不 一 样 。 可 以 鹿 接 将 可 能 的 值 作为 参数 ， 或 者 将 其 包 在 某 个 list 中 ， 
第 一 个 值 为 缺 省 值 : 


class Items(HasTraits): 
count = Enum(None, 0, 1, 2, 3, "many") 
# 或 者 : 
# count = Enum([None, 0, 1, 2, 3, "many"]) 


下 面 是 运行 结果 : 


>>> Item = Items() 


>>> item.count = 2 
>>> item.count = "many" 
>>> item.count = 5 


如 果 你 希望 候选 值 是 可 以 变化 的 话 ， 可 以 用 values 关 键 字 指定 定义 候选 值 的 属 
性 名 : 


class Items(HasTraits): 
count_list = List([None, 0, 1, 2, 3, "many"]) 
count = Enum(values="count_list") 


我 们 定义 一 个 count _ list 列表， 然后 在 Enum 定 义 中 用 values 关 键 字 指定 候选 值 
为 count_ list 属性 。 


>>> item = Items() 

>>> item.count = 5 

Traceback (most recent call last) 

#,.，， 上 略 去 错误 提示 ， 此 错误 提示 无 法 显示 侯 选 值 列表 
>>> item.count_list.append(5) 

>>> item.count = 5 

>>> item.count 

5 


Trait 的 元 数据 


Trait 对 象 可 以 有 元 数据 属性 ， 这 些 属性 保存 在 HasTraits 对 象 的 trait 字 


了 解释 什么 是 trait 字 典 和 元 数据 ， 让 我 们 先 来 看 一 个 例子 


from enthought.traits.api import * 


class MetadataTest(HasTraits): 
工 Int(99) 
s = Str("test", desc="a string trait property") 


test = MetadataTest() 


在 IPython 中 运行 了 上 面 的 程序 之 后 ， 我 们 对 test 进 行 如 下 操作 : 


>>> test.traits() 


典 中 ， 为 


{'i': <enthought.traits.traits.CTrait object at Ox05D44EA0> 
'trait_added': <enthought.traits.traits.CTrait object at Ox 


1 


s': <enthought.traits.traits.CTrait object at 0x05D44EF8>, 


'trait_modified': <enthought.traits.traits.CTrait object at 


>>> test ta 





<enthought.traits.traits.CTrait object at 0x05D44EA0> 


>>> test.trait("s").desc 
'a string trait property' 


注意 ，trait 属 性 和 trait 对 象 是 两 个 东西 : 


o trait 属 性 : 用 于 保存 实际 的 值 ， 例 如 : testi, tests 
o trait 对 象 : 用 于 描述 trait 属 性 ， 例 如 : test.trait("i"), test.trait(" 


请 


通过 调用 HasTraits 对 象 的 traits 方 法 可 以 得 到 一 个 包含 其 所 有 trait 对 象 的 字典 。 
SE 


s") 


也 就 是 说 对 于 每 一 个 trait 属 性 都 有 一 个 与 之 对 应 的 trait 对 象 描述 它 。 而 元 数据 就 
是 保存 在 trait 对 象 中 的 额外 的 描述 属性 用 的 数据 。 我 们 看 到 test 的 trait 对 象 除了 i 
和 s 之 外 ， 还 有 trait_added 和 trait_modified， 着 两 个 在 HasTraits 类 中 定义 。 


元 数据 可 以 分 为 三 类 : 
o 内 部 属性 : 这 些 属性 是 trait 对 象 自 带 的 ， 只 读 不 能 
o 识别 属性 : 这 些 属性 是 可 以 自 由 地 设 EA, A E 些 行为 
o 任意 属性 用 户 自己 添加 的 属性 ， 需 要 自己 编写 程序 使 用 它们 
内 部 元 数据 
下 面 的 这 些 元 数据 属性 在 Traits 库 内 部 使 用 ， 用 户 可 以 读 取 它们 的 值 。 
o array: 是 否 是 数组 ， 不 是 数组 的 trait 对 象 没有 此 属性 
o default: 对 应 的 trait 属 性 的 缺 省 值 。 也 就 是 说 : trait 属 性 的 缺 省 值 是 保存 
在 与 其 对 应 的 trait 对 象 的 元 数据 属性 default 中 的 : 


>>> test.trait("i").default 
99 


o default_kind : 一 个 描述 缺 省 值 的 类 型 的 字符 串 ， 其 值 可 以 是 value, list, 
dict, self, factory method 等 : 


>>> test.trait("i").default_kind 
'value' 


O 〇 


inner_traits : 内 部 的 trait 对 象 ， 在 List, Dict 等 中 使 用 ， 表 示 List 和 Dict 内 部 
对 象 的 类 型 


trait_type : 描述 trait 属 性 的 数据 类 型 的 对 象 。 下 面 的 例子 中 ， 得 到 的 就 是 
定义 trait 属 性 时 所 用 的 Int 类 的 对 象 : 


(0) 


>>> test.trait("i").trait_type 
<enthought.traits.trait_types.Int object at 0x05DBD2D0> 


o type : trait 属 性 的 分 类 ， 可 以 是 constant, delegate, event, property, trait 


>>> test.trait("i").type 
'trait' 


能 识别 的 元 数据 
下 面 的 元 数据 属性 不 是 预定 义 的 ， 但 是 可 以 被 HasTraits 对 象 使 用 : 


desc : 描述 trait 属 性 用 的 字符 串 ， 在 界面 中 使 用 

editor : 指定 一 个 生成 界面 时 用 何 种 TraitEditor 编 辑 对 应 的 trait 属 性 

label : 界面 中 的 trait 属 性 编辑 器 的 标签 中 的 字符 串 

rich_compare : 指定 判断 trait 属 性 值 发 生变 化 的 方式 。True( 缺 省 ) 表 示 按 值 比 
较 ; Flase 表 示 按 照 对 象 指针 比较 

trait_value : 指定 trait 属 性 是 否 接受 TraitValu 类 的 对 象 ， 缺 省 值 为 False。 当 它 
为 True 时 ， 将 trait 属 性 设置 为 TraitValue()， 将 重 置 trait 属 性 值 为 缺 省 值 。 
transient : 指定 当 对 象 被 保存 (持久 化 ) 时 是 否 保存 此 trait 属 性 值 。 对 于 大 多 数 
trait 属 性 来 说 ， 它 的 缺 省 值 都 是 True。 
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当 物 体 的 某 个 属性 的 值 发 生变 化 的 时 候 ， 程 序 中 的 其 它 的 部 分 可 能 需要 响应 这 个 变 
化 。 这 种 事件 驱动 的 技术 在 界面 程序 的 编写 中 非常 常见 ， 而 Traits 库 给 trait 属 性 提供 
了 事件 处 理 功 能 ， 让 我 们 能 将 事件 驱动 模型 运用 到 更 广泛 的 场景 中 去 。 


我 们 可 以 使 用 如 下 多 种 方法 让 程序 监听 trait 属 性 值 的 变化 : 


。 静态 命名 : 通过 编写 特定 名 称 的 函数 处 理 trait 属 性 值 变化 

。 静态 修饰 : 用 修饰 汞 数 @on_trait_change 

e 动态 监听 :调用 on_trait_change() 或 者 on_trait_event() 将 trait 属 性 (事件 源 ) 和 多 
TH EK SAK ELK 


静态 命名 的 事件 义理 


设计 自己 的 Trait 编 辑 器 


在 前 面 的 章节 中 我 们 知道 ， 每 种 trait 属 性 都 对 应 有 缺 省 的 trait 编 辑 器 ， 如 果 在 View 
中 不 指定 编辑 器 的 话 ， 将 使 用 缺 省 的 编辑 器 构成 界面 。 每 个 编辑 器 都 可 以 对 应 有 多 
个 后 台 ， 目 前 支持 的 后 台 界 面 库 有 pyQt 和 wxPython。 每 种 编辑 器 都 可 以 有 四 种 祥 
式 : simple, custom, text, readonly。 


traitsU| 为 我 们 提供 了 很 丰富 的 编辑 器 库 ， 以 至 于 我 们 很 少 有 自己 设计 编辑 器 的 需 
求 ， 然 而 如 果 我 们 能 方便 地 设计 自己 的 编辑 器 ， 将 能 制作 出 更 加 专业 的 程序 界面 。 


本 章节 将 简要 介绍 trait 编 辑 器 的 工作 原理 ; 并 且 制 作 一 个 新 的 trait 编 辑 器 ， 用 以 显示 
matplotlib 提 供 的 绘图 控件 ; 然后 以 此 控件 制作 一 个 通用 的 绘制 CSV 文 件数 据 图 像 的 


小 工具 。 


Trait 编 辑 器 的 工作 原理 


我 们 先 来 看 下 面 这 个 小 程序 ， 它 定义 了 一 个 TestStrEditor 类 ， 其 中 有 一 个 名 为 test 的 
trait 属 性 ， 其 类 型 为 Str， 在 view 中 用 ltem 定 义 要 在 界面 中 显示 test 属 性 ， 但 是 没 
指定 它 所 使 用 的 编辑 器 (通过 editor 参 数 )。 当 执行 tconfigure_traits() 时 ，traits 库 将 自 
动 为 我 们 挑选 文本 编辑 框 控件 作为 test 属 性 的 编辑 器 : 


from enthought.traits.api import * 
from enthought.traits.ui.api import * 


class TestStrEditor(HasTraits): 
test = Str 
view = View(Item("test")) 
t = TestStrEditor() 
t.configure_traits() 


QET le 





Test: 


使 用 文本 编辑 框 控件 编辑 test 属 性 
Traits 库 的 路 径 
下 面 的 介绍 需要 查看 traits 库 的 源 程 序 ， 因 此 首先 你 需要 知道 它们 在 哪里 : 


traits: site-packages\Traits-3.2.0-py2.6-win32.egg\enthought\traits, 以 下 简称 
%traits% 


traitsUI: site-packages\Traits-3.2.0-py2.6-win32.egg\enthought\traits\UI, 以 下 简称 
Aui% 


WX 后 台 界 面 库 : site-packages\TraitsBackendWX-3.2.0- 
py2.6.egg\enthought\traitsui\wx, 以 下 简称 %wx% 


Str 对 象 的 缺 省 编辑 器 通过 其 create_editor 方 法 获得 : 


>>> from enthought.traits.api import * 
>>> s = Str() 
>>> ed = s.create_editor() 
>>> type(ed) 
<class 'enthought.traits.ui.editors.text_editor.ToolkitEditorFacto1 
>>> ed.get() 
{'auto_set': True, 
'custom_editor_class': <class 'enthought.traits.ui.wx.text_editor 
‘enabled': True, 
‘enter_set': False, 
"evaluate': <enthought.traits.ui.editors.text_editor. Identity ob: 


‘evaluate_name': '', 
'format_func': None, 
Pronmabestre: . 于 
rlinvalid? s )S, 


'is_ grid_cell': False, 

‘mapping': {}, 

'multi_line': True, 

'password': False, 

"'readonly_editor_class': <class 'enthought.traits.ui.wx.text_edit¢ 
'simple_editor_class': <class 'enthought.traits.ui.wx.text_editor 
'text_editor_class': <class 'enthought.traits.ui.wx.text_editor.S: 
'view': None} 





create_editor 方 法 的 源 代码 可 以 在 %traits%trait_types.py 中 的 BaseStr 类 的 定义 中 找 
到 。create_editor 方 法 得 到 的 是 一 个 text_editor.ToolkitEditorFactory 类 : 


enthought.traits.ui.editors.text_editor.ToolkitEditorFactory 


在 %ui%editorstext_editor.py 中 你 可 以 找到 它 的 定义 ， 它 继承 于 EditorFactory 类 。 
EditorFactory 类 的 代码 在 %ui%editor_factory.py 中 。EditorFactory 类 是 Traits 编 辑 器 
的 核心 ， 通 过 它 和 后 台 界 面 库 联 系 起 来 。 让 我 们 来 详细 看 看 EditorFactory 类 中 关于 
控件 生成 方面 的 代码 : 


class EditorFactory ( HasPrivateTraits ): 
# 下 面 四 个 属性 描述 四 个 类 型 的 编辑 器 的 类 
simple editor_class = Property 
custom editor_class = Property 
text_editor_class = Property 
readonly_editor_class = Property 


# 用 Simple_editor class 创建 实际 的 控件 
def Simple editor ( self, ui, object, name, description, parent 
return self.simple _editor_class( parent, 


factory = self, 

ui = ul, 

object = object, 
name = name, 
description = description 


# 这 是 类 的 方法 ， 它 通过 类 的 以 及 父 类 自动 找到 与 其 匹配 的 后 台 界 面 库 中 的 控件 类 
@classmethod 
def _get_toolkit_editor(cls, class_name): 
editor_factory_classes = [factory_class for factory_class : 
if issubclass(factory_class, Edit 
for index in range(len( editor_factory_classes )): 
try: 
factory_class = editor_factory_classes[ index] 
editor_file_name = os.path.basename( 
sys.modules[factory_class.__module_ 
return toolkit_object(':'.join([editor_file_name.s; 
class_name]), True) 
except Exception, e: 
if index == len(editor_factory_classes)-1: 
raise e 
return None 


# simple_editor_class 属 性 的 get 方 法 ， 获 取 属 性 值 
def _get_simple editor_class(self): 
try: 
SimpleEditor = self._get_toolkit_editor('SimpleEditor' | 
except: 
SimpleEditor = toolkit_object('editor_factory:SimpleEd: 
return SimpleEditor 


EJE 


EditorFactory 的 对 象 有 四 个 属性 保存 后 台 编 辑 器 控件 的 类 : simple_editor_class, 
custom_editor_class, text_editor_class, readonly_editor_class。 例 如 前 面 例子 中 
的 ed 对 象 的 simple_editor_class 为 <class 
'enthought.traits.ui.wx.text_editor.SimpleEditor>， 我 们 看 到 它 用 的 是 wx 后 台 界面 
库 中 的 text_editor 中 的 SimpleEditor 类 ， 稍 后 我 们 将 看 看 其 内 容 。 


EditorFactory 是 通过 其 类 方法 _get toolkit_editor 计 算出 所 要 用 后 台 界 面 库 中 的 类 
的 。 由 于 _get toolkit _ editor 是 类 方法 ， 它 的 第 一 个 参数 cls 就 是 类 本 身 。 当 调用 
text_editor.ToolkitEditorFactory，get toolkit editor() 时 ，cls 就 是 





text_editor. ToolkitEditorFactory 类 。 通 过 调用 cls.mro 获 得 cls 以 及 其 所 有 父 类 ， 然 后 
一 个 一 个 地 查找 ， 从 后 台 界 面 库 中 找到 与 之 匹配 的 类 ， 这 个 工作 由 toolkit _object 画 
数 完成 。 其 源 代码 可 以 在 %ui%toolkit.py 中 找到 。 


因为 后 台 界 面 库 中 的 类 的 组 织 结构 和 traits.ui 是 一 样 的 ， 因 此 不 需要 额外 的 配置 文 
件 ， 只 需要 几 个 字符 串 替 代 操 作 就 可 以 将 traits.ui 中 的 EditorFactory 类 和 后 台 界面 库 
中 的 实际 的 编辑 器 类 联系 起 来 。 下 图 显示 了 traits.ui 中 的 EditorFactory 和 后 台 界 面 库 
的 关系 。 


traits.ui traits.ui.wx 


EditorFactory ”区 -一 Simple_editor_class- 一 种; text_editor.SimpleEditor 
x | 


text_editor.ToolkitEditorFactory | 











traits.ui 中 的 EditorFactory 和 后 台 界 面 库 的 关系 


WX 后 台 界 面 库 中 定义 了 所 有 编辑 器 控件 ， 在 %wx%text_editor.py 中 你 可 以 找到 产 
生 文 本 框 控件 的 类 text_editor.SimpleEditor。 类 名 表示 了 控件 的 样式 : simple, 
custom, text, readonly， 而 其 文件 名 (模块 名 ) 则 表示 了 控件 的 类 型 。 下 面 是 
text_editor.SimpleEditor 的 部 分 代码 : 


class SimpleEditor ( Editor ): 


# Flag for window styles: 
base_style = 0 


# Background color when input is OK: 
ok_color = OKColor 


# Function used to evaluate textual user input: 
evaluate = evaluate_trait 


def init ( self, parent ): 
"""”Finishes initializing the editor by creating the under: 
widget. 


factory self. factory 
style self.base_style 
self.evaluate factory.evaluate 


self.sync_value( factory.evaluate_name, 'evaluate', ‘from' 


if (not factory.multi_line) or factory.password: 
style &= ~wx.TE_MULTILINE 


if factory.password: 
style |= wx.TE_PASSWORD 


multi_line = ((style & wx.TE_MULTILINE) != 0) 
if multi_line: 
self.scrollable = True 


if factory.enter_set and (not multi_line): 
control = wx.TextCtrl( parent, -1, self.str_value, 
style = style | wx.TE_PROCESS EI 
wx.EVT_TEXT_ENTER( parent, control.GetId(), self.update 
else: 
control = wx.TextCtrl( parent, -1, self.str_value, sty: 


wx.EVT_KILL_FOCUS( control, self.update_object ) 


if factory.auto_set: 
wx.EVT_TEXT( parent, control.GetId(), self.update_objec 


self.control = control 
self.set_tooltip() 


a] as a 


真正 产生 控件 的 程序 是 在 init 方 法 中 ， 此 方法 在 产生 界面 时 自动 被 调用 ， 注 意 方 法 名 
是 init， 不 要 和 对 象 初 始 化 方法 _init_ 摘 混淆 了 。 





制作 matplotlib 的 编辑 器 


Enthought 的 官方 绘图 库 是 采用 Chaco， 不 过 如 果 你 对 matplotlib 库 更 加 熟悉 的 话 ， 
将 matplotlib 的 绘图 控件 从 入 TraitsUl 界 面 中 将 是 非常 有 用 的 。 下 面 先 来 看 一 下 人 散 人 
matplotlib 控 件 的 完整 源 代 码 : 


# -*- coding: utf-8 -*- 

# file name: mpl_figure_editor.py 

import wx 

import matplotlib 

# matplot1lib 采 用 WXAgg 为 后 台 ， 这 样 才能 将 绘图 控件 谨 入 以 wx 为 后 台 界面 库 的 traits 
matplotlib.use("WXAgg") 

from matplotlib.backends.backend_wxagg import FigureCanvasWxAgg as 
from matplotlib.backends.backend_wx import NavigationToolbar2wx 
from enthought.traits.ui.wx.editor import Editor 

from enthought.traits.ui.basic_editor_factory import BasicEditorFac 


class _MPLFigureEditor(Editor): 


相当 于 wx 后 台 界 面 库 中 的 编辑 器 ， 它 负责 创建 真正 的 控件 


scrollable = True 


def init(self, parent): 
self.control = self._create_canvas(parent ) 
self.set_tooltip() 
print dir(self.item) 


def update_editor(self): 
pass 


def _create_canvas(self, parent): 
创建 一 个 Pane1L， 布局 采用 垂直 排列 的 BoxSizer，pane1 中 中 添加 
FigureCanvas, NavigationToolbar2wx，StaticText 三 个 控件 
FigureCanvas 的 鼠标 移动 事件 调用 mousemoved 辑 数 ， 在 StaticText 
显示 最 标 所 在 的 数据 坐标 
panel = wx.Panel(parent, -1, style=wx.CLIP_CHILDREN) 
def mousemoved(event ) : 
panel.info.SetLabel("%s, %s" % (event.xdata, event. ydat 
panel.mousemoved = mousemoved 
sizer = wx.BoxSizer(wx.VERTICAL) 
panel.SetSizer(sizer) 
mpl_control = FigureCanvas(panel, -1, self.value) 
mpl_control.mpl_connect("motion_notify_event", mousemoved) 
toolbar = NavigationToolbar2wx(mpl_ control) 
sizer .Add(mpl_control, 1, wx.LEFT | wx.TOP | wx.GROW) 
sizer .Add(toolbar, ©, wx.EXPAND|wx.RIGHT) 
panel.info = wx.StaticText(parent, -1) 
sizer .Add(panel.info) 


self .value.canvas.SetMinSize((10,10) ) 
return panel 


class MPLFigureEditor(BasicEditorFactory): 


相当 于 traits,ui 中 的 EditorFactory， 它 返回 真正 创建 控件 的 类 


klass = _MPLFigureEditor 


if _ name == " main_": 
from matplotlib.figure import Figure 
from enthought.traits.api import HasTraits, Instance 
from enthought.traits.ui.api import View, Item 
from numpy import sin, cos, linspace, pi 


class Test(HasTraits): 

figure = Instance(Figure, ()) 

view = View( 
Item("figure", editor=MPLFigureEditor(), show_label=Fa- 
width = 400, 
height = 300, 
resizable = True) 

def _ init__(self): 
super(Test, self). _init_ () 
axes = self.figure.add_subplot(111) 
t = linspace(0, 2*pi, 200) 
axes.plot(sin(t) ) 


Test().configure_traits() 


Ei 
此 程序 的 运行 结果 如 下 : 
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82.4372759857, 0.52380952381 
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由 于 我 们 的 编辑 器 没有 simple 等 四 种 样式 ， 也 不 会 放 到 wx 后 台 界 面 库 的 模块 中 ， 因 
此 不 能 采用 上 节 所 介绍 的 自动 查找 编辑 器 类 的 办 法 。traits.ui 为 我 们 提供 一 个 一 个 方 
便 的 类 来 完成 这 些 操 作 : BasicEditorFactory。 它 的 源 程 序 可 以 在 
%ui%basic_editor_ factory.py 中 找到 。 下 面 是 其 中 的 一 部 分 : 


class BasicEditorFactory ( EditorFactory ): 
klass = Any 


def _get_simple_editor_class ( self ): 
return self.klass 


它 通 过 重 坊 EditorFactory 中 的 simple_editor_class 属 性 ， 直 接 返 回 创 建 控件 的 库 
klasse MPLFigureEditor 继 承 于 BasicEditorFactory， 指 定 创建 控件 的 类 为 
_MPLFigureEditor。 


和 text _editor.SimpleEditor 一 样 ， 从 Editor 类 继承 ， 在 _MPLFigureEditor 类 的 init 方 
法 中 ， 创 建 实际 的 控件 。 因 为 Editor 类 中 有 一 个 update_editor 方 法 ， 在 其 对 应 的 trait 
属性 改变 是 会 被 调用 ， 而 我 们 的 绘图 控件 不 需要 这 个 功能 ， 所 以 重 载 
update_editor， 让 它 不 做 任何 事情 。 


matplotlib 中 ， 在 创建 FigureCanvas 时 需要 指定 与 其 对 应 的 Figure 对 象 : 


mpl_control = FigureCanvas(panel, -1, self.value) 


这 里 self.value 就 是 这 个 Figure 对 象 ， 它 在 MVC 的 模型 类 Test 中 被 定义 为 : 


figure = Instance(Figure, ()) 


控件 类 可 以 通过 self.value 获 得 与 其 对 应 的 模型 类 中 的 对 象 。 因 此 _MPLFigureEditor 
中 的 self.value 和 Test 类 中 的 self.figure 是 同一 个 对 象 。 


_create_canvas 方 法 中 的 程序 编写 和 在 一 个 标准 的 wx 窗口 中 添加 控件 是 一 样 的 ， 界 
面 库 相 关 的 细节 不 是 本 书 的 重点 ， 因 此 不 再 详细 解释 了 。 读 者 可 以 参照 matplotlib 和 
wxPython 的 相应 文档 。 


CSV 数 据 绘图 工具 

下 面 用 前 面 介绍 的 matplotlib 编 辑 器 制作 一 个 CSV 数 据 绘图 工具 。 用 此 工具 打开 一 个 
CSV 数 据 文档 之 后 ， 可 以 绘制 多 个 X-Y 坐 标 图 。 用 户 可 以 自由 地 添加 新 的 坐标 图 ， 
修改 坐标 图 的 标题 ， 选 择 坐 标 图 的 X 轴 和 Y 轴 的 数据 。 

下 面 是 此 程序 的 界面 截图 : 
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CSV 数 据 绘图 工具 的 界面 


图 中 以 标签 页 的 形式 显示 多 个 绘图 ， 用 户 可 以 从 左 侧 的 数据 选择 栏 中 选择 X 轴 和 Y 轴 
的 数据 。 标 签 页 可 以 自由 的 拖 动 ， 构 成 上 下 左右 分 栏 ， 并 且 可 以 隐藏 左 侧 的 数据 选 


择 栏 : 
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使 用 可 调整 DOCK 的 多 标签 页 界面 方便 用 户 对 比 数 据 


由 于 绘图 控件 是 matplotlib 所 提供 的 ， 因 此 平移 、 缩 放 、 保 存 文件 等 功能 也 一 上 应 俱 
全 。 由 于 所 有 的 界面 都 是 采用 TraitsUl 设 计 的 ， 因 此 主 窗口 既 可 以 用 来 单独 显示 ， 
也 可 以 戏 入 到 一 个 更 大 的 界面 中 ， 运 用 十 分 灵活 。 


下 面 是 完整 的 源 程 序 ， 运 行 时 需要 和 mpl figure_editorpy 放 在 一 个 文件 夹 下 。 包 括 
注释 程序 一 共 约 170 行 ， 编 写 时 间 少 于 一 小 时 。 


# -*- coding: utf-8 -*- 


From 
From 
From 
From 


matplotlib.figure import Figure 
mpl_figure_editor import MPLFigureEditor 
enthought.traits.ui.api import * 
enthought.traits.api import * 


import csv 


class DataSource(HasTraits): 


数据 源 ，data 是 一 个 字典 ， 将 字符 串 映 射 到 列表 
names 是 data 中 的 所 有 字符 串 的 列表 


data = DictStrAny 
names = List(Str) 


def load_csv(self, filename): 


从 CSV 文 件 读 入 数据 ， 更 新 data 和 names 属 性 


f = file(filename) 

reader = csv.DictReader(f) 

self.names = reader.fieldnames 

for field in reader.fieldnames: 
self.data[field] = [] 

for line in reader: 
for k, v in line.iteritems(): 

self .data[k].append(float(v)) 
f.close() 


class Graph(HasTraits): 


绘图 组 件 ， 包 括 左边 的 数据 选择 控件 和 右边 的 绘图 控件 


name = Str # 绘图 名 ， 显 示 在 标签 页 标题 和 绘图 标题 中 
data_source = Instance(DataSource) # 保存 数据 的 数据 源 
figure = Instance(Figure) # 控制 绘图 控件 的 Figure 对 象 
selected_xaxis = Str # X 轴 所 用 的 数据 名 
selected_items = List # Y 轴 所 用 的 数据 列表 


clear_button = Button(u" 清 除 ") # 快速 清除 Y 轴 的 所 有 选择 的 数据 


view = View( 
HSplit( # HSp1it 分 为 左右 两 个 区 域 ， 中 间 有 可 调节 宽度 比例 的 调节 手柄 
# 左边 为 一 个 组 
VGroup( 
Item("name"), # 绘图 名 编辑 框 
Item("clear_button"), # 清除 按钮 
Heading(u"X 轴 数据 ")， # 静态 文本 
H X 轴 选择 器 ， 用 EnumEditor 编 辑 器 ， 即 ComboBox 控 件 ， 控 件 中 忆 
# data_source 的 names 属 性 得 到 
Item("selected_xaxis", editor= 
EnumEditor (name="object.data_source.names", foi 


Heading(u"Y 轴 数据 ")，# 静态 文本 

H Y 轴 选择 器 ， 由 于 Y 轴 可 以 多 选 ， 因 此 用 CheckBox 列 表 编 辑 ， 按 两 

Item("selected items", style="custom", 
editor=CheckListEditor (name="object.data_sour¢ 

cols=2, format_str=u"%s")), 

show_border = True, # 显示 组 的 边框 

scrollable = True, # 组 中 的 控件 过 多 时 ， 采 用 滚动 条 

show_labels = False # 组 中 的 所 有 控件 都 不 显示 标签 


), 
# 右边 绘图 控件 
Item("figure", editor=MPLFigureEditor(), show_label=Fa- 


) 


def _name_changed(self): 


当 绘图 名 发 生变 化 时 ， 更 新 绘图 的 标题 
axe = self.figure.axes[0] 
axe.set_title(self.name) 
self .figure.canvas.draw() 


def _clear_button_fired(self): 


清除 按钮 的 事件 处 理 
self.selected items = [] 
self.update() 


def _figure_default(self): 


figure 属 性 的 缺 省 值 ， 直 接 创 建 一 个 Figure 对 象 
figure = Figure() 
figure.add_axes([0.05, 0.1, 0.9, 0.85]) # 添 加 绘图 区 域 ， 四 周 留 
return figure 


def _selected_items_changed(self): 


Y 轴 数据 选择 更 新 


self .update() 


def _selected_xaxis_changed(self): 


X 轴 数据 选择 更 新 


self .update() 


def update(self): 


重新 绘制 所 有 的 曲线 


axe = self.figure.axes[0] 
axe.clear() 
try: 

xdata = self.data_source.data[self.selected_xaxis] 
except: 

return 
for field in self.selected_items: 

axe.plot(xdata, self.data_source.data[field], label=fie 
axe.set_xlabel(self.selected_xaxis) 
axe.set_title(self.name) 
axe. legend() 
self .figure.canvas.draw() 


class CSVGrapher(HasTraits): 


主 界面 包括 绘图 列表 ， 数 据 源 ， 文 件 选择 器 和 添加 绘图 按钮 
graph_list = List(Instance(Graph)) # 绘图 列表 
data_source = Instance(DataSource) # 数据 源 
csv_file_name = File(filter=[u"*.csv"]) # 文件 选择 
add_graph_button = Button(u" 添 加 绘图 ") # 添加 绘图 按钮 


view = View( 
# 整个 窗口 分 为 上 下 两 个 部 分 
VGroup( 
# 上 部 分 横向 放置 控件 ， 因 此 用 HGroup 
HGroup( 
# 文件 选择 控件 
Item("csv_file_name"，1abe1=u" 选 择 CSV 文 件 "，width=46 
# 添加 绘图 按钮 
Item("add_graph_button", show_label=False) 
), 
# 下 部 分 是 绘图 列表 ， 采 用 ListEditor 编 辑 器 显示 
Item("graph_list", style="custom", show_label=False, 
editor=ListEditor ( 
use_notebook=True, # 是 用 多 标签 页 格式 显示 
deletable=True, # 可 以 删除 标签 页 
dock_style="tab", # 标签 dock 样 式 
page_name=".name") # 标题 页 的 文本 使 用 Graph 对 象 的 n 
) 
), 


resizable = True, 
height = 0.8, 

width 0.8, 

title = U"CSV 数 据 绘 图 器 " 


) 


def _csv_file_name_changed(self): 


打开 新 文件 时 的 处 理 ， 根 据 文件 创建 一 个 DataSource 





self.data_source = DataSource() 
self .data_source.load_csv(self.csv_file_name) 


del self.graph_list[:] 


def _add_graph_button_changed(self): 


添加 绘图 按钮 的 事件 处 理 


if self.data_source != None: 
self.graph_list.append( Graph(data_source = self.data_: 


if _name == " main _": 
csv_grapher = CSVGrapher() 


csv_grapher.configure_traits() 
FE ae ay: 


程序 中 已 经 有 比较 详细 的 注释 ， 这 里 就 不 再 重复 。 如 果 你 对 traits 库 的 某 项 用 法 还 不 
太 了 解 的 话 ， 可 以 直接 查看 其 源 代 码 ， 代 码 中 都 有 详细 的 注释 。 下 面 是 几 个 比较 重 
点 的 部 分 : 


。 整个 程序 的 界面 义理 都 只 是 组 装 View 对 象 ， 看 不 到 任何 关于 控件 操作 的 代码 ， 
因此 大 大 地 节省 了 程序 的 开发 时 间 。 


e 通过 配置 141 行 的 ListEditor， 使 其 用 标签 页 的 方式 显示 graph_list 中 的 每 个 元 
素 ， 以 此 管理 多 个 Graph 对 象 。 


e 在 43 行 中 ，Graph 类 用 HSplit 将 其 数据 选择 部 分 和 绘图 控件 部 分 分 开 ，HSplit 提 
供 的 更 改 左 右 部 分 的 比例 和 隐藏 的 功能 。 


e 本 书写 作 时 所 采用 的 traitsUl 库 版 本 为 3.2， 如 果 在 标签 页 标题 中 输入 中 文 ， 会 
出 现 错 误 ， 这 是 因为 TraitsUl 中 还 有 些 代 码 对 unicode 的 支持 不 够 ， 希 望 日 后 会 
有 所 改善 。 目 前 可 以 通过 分 析 错 误 提 示 信 息 ， 修 改 TraitsUl 库 的 源 代 码 ， 只 需 
要 将 下 面 提 示 中 的 770 行 中 的 str 改 为 unicode 既 可 以 修复 。 





&gt;&gt;&gt; from visual import * 


之 后 就 可 以 随心 所 欲 的 调用 visual 库 通过 的 函数。 需要 注意 的 是 如 果 你 关闭 了 visual 
弹出 的 场景 窗口 的 话 ，ipython 对 话 也 随 之 结束 。 如 果 你 需要 关闭 场景 窗口 可 以 用 下 
面 的 语句 : 


>>> scene.visible = False 





or more information, type ‘help(pylab)° 
from visual import 
a = box() 
b box(pos«(4,4,4), 
c = sphere(pos=(2,2,2),color=color. green) 


display 


d sphere(color=color.yel low) 





在 IPython 中 交互 式 地 观察 visual 的 运行 结果 


es i 可 以 看 到 通过 IPython 能 够 控制 多 
个 场景 窗口 


。 场景 窗口 
o 控制 场景 窗口 
o 控制 照相 机 


Visual 使 用 手册 


在 ipython 中 交互 式 地 使 用 
visual 库 可 以 在 IPython 中 交互 式 的 人 使用， 启动 ipython 之 后 ， 只 需要 先 执行 : 


>>> from visual import * 


之 后 就 可 以 随心 所 欲 的 调用 visual 库 通过 的 画 数 。 需 要 注意 的 是 如 果 你 关闭 了 visual 
弹出 的 场景 窗口 的 话 ，ipython 对 话 也 随 之 结束 。 如 果 你 需要 关闭 场景 窗口 可 以 用 下 
面 的 语句 : 


>>> scene.visible = False 








图 14.1 在 IPython 中 交互 式 地 观察 visual 的 运行 结果 


上 图 是 用 IPython 交 互 式 的 使 用 visual 的 一 个 例子 ， 可 以 看 到 通过 IPython 能 够 控制 多 
个 场景 窗口 。 


场景 窗 


visual 中 的 所 有 的 3D 物 体 都 在 一 个 窗口 中 显示 ， 此 窗口 为 display 类 的 对 象 ， 通 过 这 
对 象 我 们 可 以 修改 窗口 的 各 种 属性 ; 控制 场景 中 的 照相 机 ， 人 


控制 场景 窗口 


从 visual 库 载 人 所 有 对 象 之 后 ， 缺 省 情况 下 ， 有 一 个 可 以 用 变量 scene 访 问 的 缺 省 的 
场景 窗口 对 象 ， 它 也 是 初始 情况 下 的 当前 窗口 : 


>>> from visual import * 
>>> scene 
<visual.ui.display object at 0x032BF600> 


我 们 看 到 场景 窗口 对 象 是 visual.ui.display 类 的 一 个 实例 。 真 正 的 窗口 需要 在 其 中 放 
置物 体 才 会 被 显示 出 来 。 因 此 如 果 我 们 用 display() 创 建 自己 的 窗口 对 象 的 话 ， 那 么 
可 以 不 用 管 这 个 缺 省 的 窗口 对 象 ， 我 们 创建 的 窗口 对 象 将 变 成 当前 窗口 。 用 box 等 
人 下 面 语句 调用 display 创 建 一 个 新 的 窗口 对 


>>> scene2 = display(title='Scene2', x=0, y=0, width=600, height=2( 
center=(5,0,0), background=(0,1,1)) 


| 


执行 上 面 的 语句 之 后 ， 将 创建 一 个 标题 为 Scene2 的 窗口 ， 其 左上 角 的 坐标 为 
(0,0)， 宽 度 为 600 像 素 ， 高 度 为 200 像 素 ， 照 相机 所 正 对 的 位 置 的 坐标 (5,0,0)， 也 就 
是 说 窗口 中 心 的 点 的 3D 坐 标 为 (5,0,0)， 背 景 为 青色 。 注 意 要 显示 窗口 ， 我 们 需要 往 
里 面 放 物 体 : 





>>> box() 
>>> <visual.primitives.box object at 0x0334F090> 


>>> box(pos=(5,0,0), color=color.red) 
>>> <visual.primitives.box object at 0x0334F120> 


B— SILA ARE T RAY (0,00)%, Bme*AREAHAS ; 第 二 个 立方 体 放 在 
了 坐标 (5,0,0) 勾 ， 颜 色 为 红包。 红色 立方 体 在 窗口 的 中 心 ， 和 我 们 设置 的 窗口 的 
center 属 性 一 致 。 





在 场景 中 放置 立方 体 


我 们 可 以 调用 窗口 对 象 的 select 方 法 使 其 成 为 当前 窗口 。 通 过 display.get_selected() 
可 以 获得 当前 窗口 对 象 : 


>>> scene.select() 

>>> sphere() 

<visual.primitives.sphere object at 0x0331D7B0> 
>>> scene2.select() 

>>> sphere(pos=(2.5,0,0), color=color.blue) 
<visual.primitives.sphere object at 0x0331D810> 
>>> display.get_selected() == scene2 

True 


上 面 的 程序 先 将 scene 改 为 当前 窗口 ， 然 后 在 其 中 创建 一 个 球体 ; 接着 将 scene2 改 
为 当前 窗口 ， 在 其 中 创建 一 个 蓝 色 的 球体 ， 放 在 坐标 (2.5,0,0) 处 。 最 后 调用 
display.get_selected() 检 查 当 前 窗口 是 否 是 scene2。 执 行 这 段 程序 之 后 ， 将 出 现 两 
个 场景 窗口 ， 缺 省 窗口 的 标题 为 VPython， 其 中 有 一 个 球体 ; 我 们 自己 创建 的 窗口 
标题 为 Scene2， 其 中 有 两 个 立方 体 和 一 个 球体 。 





在 第 二 个 场景 中 放置 球体 


窗口 对 象 有 如 下 的 属性 : 


e foreground : 在 窗口 中 创建 物体 时 所 采用 的 缺 省 颜色 ， 缺 省 值 为 白色 。 例 如 运 
{T scene.foreground = color.green 之 后 ， 窗 口中 新 添加 的 物体 如 果 不 指 定 颜 
色 的 话 就 会 是 绿色 的 。 


e background: 窗口 的 背景 颜色 ， 缺 省 值 为 黑色 。 


e ambient : 环境 光 的 颜色 ， 缺 省 值 为 color.gray(0.2)， 为 了 和 visual 3 兼容 ， 使 
用 scene.ambient=0.2 和 scene.ambient=color.gray(0.2) 是 一 样 的 。 


。 lights: 场景 窗口 中 的 光源 列表 ， 场 景 中 的 缺 省 光源 为 : 


[distant_light(direction=(0.22, 0.44, 0.88), color=color.gr 
distant_light(direction=(-0.88, -0.22, -0.44), color=color 


‘| — # 
可 以 用 如 下 的 语句 查看 光源 的 属性 : 








&gt;&gt;&gt; scene.lights[0].direction 
vector(0.218217890235992，0.436435780471985，0.872871560943 


‘| 








e cursor.visible : 控制 场景 窗口 中 鼠标 是 否 显示 ， 如 果 设 置 为 False 的 话 ， 那 么 
鼠标 将 被 隐藏 。 你 可 以 用 它 在 用 妃 标 拖 搜 物体 时 隐藏 妃 标 ， 释 放 物 体 时 显示 她 
标 。 


e objects : 窗口 中 所 有 可 见 的 物体 的 列表 ， 被 隐藏 的 物体 和 光源 不 在 此 列表 之 
中 ， 当 通过 设置 某 物体 的 visible 属 性 隐藏 它 时 ， 其 效果 就 是 将 它 从 此 列表 中 删 
除 。 下 面 的 语句 让 场景 中 所 有 的 box 都 变 成 红色 : 


for obj in scene2.objects: 
if isinstance(obj, box): 
obj.color = color.red 


e show_rendertime : 如 果 其 值 为 true， 那 么 在 窗口 的 左下 角 将 显示 如 
"cycle:27: 5" 的 字样 。 它 表示 场景 润色 的 帧 之 间 的 间隔 为 27 毫 秒 ， 每 帧 需要 5 
毫秒 时 间 润 色 。 这 表明 用 户 的 Python 程序 每 帧 有 22 毫 秒 的 义理 时 间 。 


stero : 立体 视觉 设置 。 如 果 你 有 双色 3D 立 体 眼镜 的 话 ， 不 妨 试 试 这 个 选项 。 

例如 scene.stereo="redcyan"， 将 润色 为 红 - 青 立 体 眼镜 用 的 场景 ， 此 外 还 

有 "redblue" 和 "yellowblue" 等 选项 。 此 外 还 可 以 设置 为 "crosseyed"， 它 将 润色 
左右 两 个 场景 ， 当 你 左右 眼 交 叉 聚焦 到 右 左 两 个 图 时 ， 产 生 立 体 效果 。 和 流行 
一 时 的 立体 图 片 类 似 ， 反 正 我 是 看 不 出 来 。 设 置 为 "active" 的 话 ， 产 生 可 以 用 

shutter glasses 观 看 的 立体 场景 。 


e stereodepth : 修改 立体 视觉 的 深度 ， 缺 省 值 为 0， 设 置 为 2 有 最 好 的 立体 效 
果 。 这 个 参数 我 没有 用 过 。 


下 面 的 属性 x, y, width, height, title 和 fullscreen 等 都 只 能 在 窗口 隐藏 的 时 候 修改 。 
此 通常 是 在 用 display 创 建 窗口 的 时 候 同 时 设置 这 些 属性 。 如 果 你 需要 设置 已 经 显示 
了 的 窗口 的 属性 的 话 ， 先 通过 设置 visible = False 将 其 隐藏 ， 设 置 这 些 属性 ， 最 后 再 
重新 显示 窗口 。 


e。X,y : 窗口 在 屏幕 中 的 位 置 ， 窗 口 左 上 和 角 的 屏幕 坐标 

。 width, height : 整个 窗口 的 像素 宽度 和 高 度 ， 包 括 边 框 和 标题 栏 

e tile: 窗口 的 标题 栏 中 的 文字 ， 如 果 需 要 设置 中 文 的 话 ， 需 要 设置 为 windows 
的 缺 省 编码 ， 例 如 scene .title = u" 中 文 标题 ".encode("gb2312") 

fullscreen: 全 屏 显 示 ， 如 果 用 scene.fullscreen=True 全 屏 显 示 的 话 ， 将 没有 窗 
口 的 边框 和 标题 栏 ， 按 Esc 键 退出 


e visible: 窗口 是 否 可 见 ， 当 某 个 物体 被 添加 进 窗 口 时 ， 窗 口 将 自动 的 被 设置 为 
可 见 

e exit: 当 exit 为 False 的 时 候 ， 将 禁止 窗口 的 关闭 按钮 ， 也 就 是 无 法 通过 关闭 按 
钮 关闭 窗口 ， 缺 省 值 为 True。 


控制 照相 机 
照相 机 的 控制 是 通过 设置 窗口 的 属性 来 完成 的 。 
e center : 照相 机 所 正 对 的 3D 空 间 的 坐标 点 ， 即 使 用 户 旋转 场景 ， 照 相机 也 始终 


正 对 着 这 个 坐标 。 如 果 你 修改 了 center 的 值 的 话 ， 照 相机 将 保持 其 方向 不 变 ， 
进行 平行 移动 使 得 其 正 对 center 坐 标 。center 的 缺 省 值 为 (0,0,0)。 





照相 机 也 进行 同样 的 平移 
使 得 其 正 对 着 (1,8,8) 


改变 照相 体 的 center 属 性 对 照相 机 进行 平移 


e autocenter : 如 果 设 置 为 True 的 话 ， 将 自动 计算 center 属 性 ， 使 得 它 为 包含 所 
有 物体 的 最 小 的 长 方 体 的 中 心 ， 此 最 小 长 方 体 的 各 边 与 x, y, z 轴 平行 。 这 样 ， 
照相 机 始终 跟随 着 场景 中 的 物体 ， 因 此 如 果 你 移动 了 场景 中 的 任何 物体 ， 都 有 
可 能 改变 center 属 性 。 


e forward : 照相 机 所 指向 的 方向 。 也 就 是 从 照相 机 所 在 的 位 置 到 center 的 方向 矢 
量 。 用 户 不 能 直接 修改 照相 机 所 在 的 位 置 ， 但 可 以 通过 scene.mouse.camera 
获得 。 当 用 户 旋 转 场 景 时 ， 其 实 就 是 在 修改 forward 属 性 。 当 forward 被 修改 之 
后 ， 照 相机 将 会 改变 其 位 置 使 得 其 方向 和 forward 矢 量 平行 ， 其 中 心 正 对 center 
点 。forward 的 缺 省 值 为 (0,0,-1)， 因 此 是 从 上 往 下 的 俯视 观察 场景 。 


FA Python 做 科学 计算 





forward 的 改变 使 得 照相 机 的 方向 和 位 置 都 改变 


-一 一 O 一 照相 机 始终 对 着 center 


forward 属 性 改变 照相 机 的 方向 和 位 置 
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声音 的 输入 输出 


在 本 章 我 们 将 学 习 如 何 读 写 WAV 文 件 ， 如 何 利用 声卡 实时 地 进行 声音 的 输入 输出 。 
标准 的 Python 已 经 支持 WAV 文 件 的 读 写 ， 而 实时 的 声音 输入 输出 需要 安装 
pyAudio(hitp://people.csail.mit.edu/hubert/pyaudio)。 最 后 我 们 还 将 看 看 如 何 使 用 
pyMedia(http://pymedia.org) 进 行 Mp3 的 解码 和 播放 。 


掌握 了 上 面 的 基础 知识 之 后 ， 就 可 以 做 许多 有 趣 的 声效 处 理 的 算法 实验 了 。 声 效 处 
理 方面 的 内 容 将 在 以 后 的 章节 详细 介绍 。 


读 写 Wave 文件 


WAV 是 Microsoft 开 发 的 一 种 声音 文件 格式 ， 虽 然 它 支持 多 种 压缩 格式 ， 不 过 它 通常 
被 用 来 保存 未 压缩 的 声音 数据 (PCM 脉冲 编码 调制 )。WAV 有 三 个 重要 的 参数 : 声 
道 数 、 取 样 频 率 和 量化 位 数 。 

。 声 道 数 : 可 以 是 单 声 道 或 者 是 双 声 道 

。 采样 频率 : 一 秒 内 对 声音 信号 的 采集 次 数 ， 常 用 的 有 8kHz, 16kHz, 32kHz, 
48kHz, 11.025kHz, 22.05kHz, 44.1kHz 
量化 位 数 : 用 多 少 bit 表 达 一 次 采样 所 采集 的 数据 ， 通 常 有 8bit、16bit、24bit 和 
32bit 等 几 种 


例如 CD 中 所 储存 的 声音 信和 号 是 双 声 道 、44.1kHz、16bit。 


如 果 你 需要 自己 录制 和 编辑 声音 文件 ， 推 荐 使 用 
Audacity(http://audacity.sourceforge.net)， 它 是 一 款 开 源 的 、 跨 平台 、 多 声 道 的 录 
音 编辑 软件 。 在 我 的 工作 中 经 常 使 用 Audacity 进 行 声音 信号 的 录制 ， 然 后 再 输出 成 
WAV 文 件 供 Python 程 序 处 理 。 


读 Wave 文 件 
下 面 让 我 们 来 看 看 如 何在 Python 中 读 写 声 音 文 件 : 


# -*- coding: utf-8 -*- 
import wave 

import pylab as pl 
import numpy as np 


# 打开 WAV 文 档 
f = wave.open(r"c:\WINDOWS\Media\ding.wav", "rb") 


# 读 取 格 式 信息 

# (nchannels, sampwidth, framerate, nframes, comptype, compname) 
params = f.getparams() 

nchannels, sampwidth, framerate, nframes = params[:4] 


# 读 取 波形 数据 
str_data = f.readframes(nframes) 
f.close() 


# 将 波形 数据 转换 为 数组 

wave_data = np.fromstring(str_data, dtype=np. short) 
wave_data.shape = -1, 2 

wave_data = wave_data.T 

time = np.arange(0, nframes) * (1.0 / framerate) 


# 绘制 波形 

pl.subplot(211) 

pl.plot(time, wave_data[0]) 
pl.subplot(212) 

pl.plot(time, wave_data[1], c="g") 
pl.xlabel("time (seconds)") 
pl.show() 
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WindowsXP 的 经 典 " 叮 " 声 的 波形 


首先 载 信 Python 的 标准 义理 WAV 文 件 的 模块 ， 然 后 调用 wave.open 打 开 wav 文 件 ， 
注意 需要 使 用 "rb"( 二 进 制 模式 ) 打 开 文 件 : 


Import wave 
f = wave.open(r"c:\WINDOWS\Media\ding.wav", "rb") 


open 返 回 一 个 的 是 一 个 Wave_read 类 的 实例 ， 通 过 调用 它 的 方法 读 取 WAV 文 件 的 
格式 和 数据 : 


e getparams : 一 次 性 返回 所 有 的 WAV 文 件 的 格式 信息 ， 它 返回 的 是 一 个 组 元 
(tuple) : 声 道 数 , 量化 位 数 (byte# fz) , 采样 频率 , 采样 点 数 , 压缩 类 型 , 压缩 
类 型 的 描述 。wave 模 块 只 支持 非 压 缩 的 数据 ， 因 此 可 以 忽略 最 后 两 个 信息 : 


params = f.getparams() 
nchannels, sampwidth, framerate, nframes = params[:4] 


e getnchannels, getsampwidth, getframerate, getnframes 等 方法 可 以 单独 返回 
WAV 文 件 的 特定 的 信息 。 


e readframes : 读 取 声 音 数据 ， 传 递 一 个 参数 指定 需要 读 取 的 长 度 〈 以 取样 点 为 
单位 ) ，readframes 返 回 的 是 二 进 制 数据 〈 一 大 堆 bytes)， 在 Python 中 用 字符 
串 表 示 二 进 制 数据 : 


str_data = f.readframes(nframes) 


接 下 来 需要 根据 声 道 数 和 量化 单位 ， 将 读 取 的 二 进 制 数据 转换 为 一 个 可 以 计算 的 数 
组 : 


wave_data = np.fromstring(str_data, dtype=np.short) 


通过 fromstring 函 数 业 字符 串 转 换 为 数组 ， 通 过 其 参数 dtype 指 定 转 换 后 的 数据 格 
式 ， 由 于 我 们 的 声音 格式 是 以 两 个 字 节 表示 一 个 取样 值 ， 因 此 采用 short 数 据 类 型 转 
换 。 现 在 我 们 得 到 的 wave_data 是 一 个 一 维 的 short 类 型 的 数组 ， 但 是 因为 我 们 的 声 
音 文件 是 双 声 道 的 ， 因 此 它 由 左右 两 个 声 道 的 取样 交替 构成 : LRLRLRLR....LR (L 
表示 左 声 道 的 取样 值 ，R 表 示 右 声 道 取 样 值 ) 。 修 改 wave_data 的 sharp 之 后 : 


wave_data.shape = -1, 2 


wave data = wave data.T 


整个 转换 过 程 如 下 图 所 示 : 
最 后 通过 取样 点 数 和 取样 频率 计算 出 每 个 取样 的 时 间 : 


time = np.arange(0, nframes) * (1.0 / framerate) 


= Wave x (+ 
写 WAV 文 件 的 方法 和 读 类 似 : 


# -*- coding: utf-8 -*- 
import wave 

import numpy as np 

import scipy.signal as signal 


framerate = 44100 
time = 10 


# 产生 10 秒 44.1kHz 的 100Hz - 1kHz 的 频率 扫描 波 

t = np.arange(0, time, 1.0/framerate) 

wave_data = signal.chirp(t, 100, time, 1000, method='linear') * 10( 
wave_data = wave_data.astype(np.short) 


打开 WAV 文 档 
= wave.open(r"sweep.wav", "wb") 


sh t+ 


# 配置 声 道 数 、 量 化 位 数 和 取样 频率 
f.setnchannels(1) 

f.setsampwidth(2) 
f.setframerate(framerate) 

# 将 wav_data 转 换 为 二 进 制 数据 写 入 文件 
f.writeframes(wave_data.tostring()) 
f.close() 
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10-12 行 通过 调用 scipy.signal 库 中 的 chrip 函 数 ， 产 生长 度 为 10 秒 、 取 样 频 率 为 
44.1kHz、100Hz 到 1kHz 的 频率 打 描 波 。 由 于 chrip 函 数 返 回 的 数组 为 float64 型 ， 需 
要 调用 数组 的 astype 方 法 将 其 转换 为 short 型 。 


18-20 行 分 别 设置 输出 WAV 文 件 的 声 道 数 、 量 化 位 数 和 取样 频率 ， 当 然 也 可 以 调用 
文件 对 象 的 setparams 方 法 一 次 性 配置 所 有 的 参数 。 最 后 21 行 调用 文件 的 
writeframes 方 法 ， 将 数组 的 内 部 的 二 进 制 数据 写 入 文件 。writeframes 方 法 会 自动 的 
更 新 WAV 文 件 头 中 的 长 度 信 息 (nframes)， 保 证 其 和 真正 的 数据 数量 一 致 。 


用 pyAudio 播 放 和 录音 


通过 上 一 节 介 绍 的 读 写 声音 文件 的 方法 ， 我 们 可 以 离线 处 理 已 经 录制 好 的 声音 。 不 
过 更 酷 的 是 我 们 可 以 通过 pyAudio 库 从 声卡 读 取 声音 数据 ， 人 处 理 之 后 再 写 回 声卡 ， 
这 样 就 可 以 在 电脑 上 实时 地 输入 、 处 理 和 输出 声音 数据 。 想 象 一 下 ， 我 们 可 以 做 一 
个 小 程序 ， 读 取 麦 元 风 的 数据 ; 加 上 回声 并 和 WAV 文 件 中 的 数据 进行 混合 ; 最 后 从 
声卡 输出 。 这 不 就 是 一 个 Karaoke 的 原型 么 。 


pyAudio 是 开源 声音 库 PortAudio( http://www.portaudio.com ) 的 Python 绑 定 ， 目 前 
它 只 支持 阻塞 式 的 输入 输出 模式 。 所 谓 阻塞 式 就 是 需要 用 户 的 程序 主动 地 去 读 写 输 
入 输出 流 。 虽 然 阻塞 式 在 功能 上 有 所 局 限 ， 但 是 由 于 编程 比较 简单 ， 非 常 适合 一 些 
处 理 声 音 的 脚本 程序 开发 。 


播放 
下 面 先 来 看 看 如 何 用 pyAudio 播 放声 音 。 


# -*- coding: utf-8 -*- 
import pyaudio 
import wave 


chunk = 1024 
wf = wave.open(r"c:\WINDOWS\Media\ding.wav", 'rb') 
p = pyaudio.PyAudio( ) 


# 打开 声音 输出 流 

stream = p.open(format = p.get_format_from_width(wf.getsampwidth() | 
channels = wf.getnchannels(), 
rate = wf.getframerate(), 
output = True) 


# 写 声 音 输出 流 进行 播放 

while True: 
data = wf.readframes(chunk) 
if data == "": break 
stream.write(data) 


stream.close() 
p.terminate() 
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这 段 程序 首先 根据 WAV 文 件 的 量化 格式 、 声 道 数 和 取样 频率 ， 分 别 iE open BESED) 
各 个 参数 ， 然 后 循环 从 WAV 文 件 读 取 数 据 ， 写 入 用 open 画 数 打 开 的 声音 输出 流 。 我 
们 看 到 17-20 行 的 while 循 环 没有 任何 等 待 的 代码 。 因 为 pyAudio 使 用 阻塞 模式 ， 
此 当 诡 层 的 输出 数据 缓存 没有 空间 保存 数据 时 ，stream.write 会 阻塞 用 户 程 序 ， 直 
到 stream.write 能 将 数据 写 入 输出 缓存 。 


PyAudio 类 的 open 辑 数 有 许多 参数 : 
e rate - 取样 频率 





e channels - 声 道 数 

e format - 取样 值 的 量化 格式 (paFloat32, palnt32, palnt24, palnt16, palnt8 
jo 在 上 面 的 例子 中 ， 使 用 get format from_width 方 法 将 wf.sampwidth() 的 返 
回 值 2 转换 为 palnt16 

e input- 输入 流标 志 ， 如 果 为 True 的 话 则 开启 输入 流 

e output - 输出 流标 志 ， 如 果 为 True 的 话 则 开启 输出 流 

e input_device_index - 输入 流 所 使 用 的 设 各 的 编号 ， 如 果 不 指定 的 话 ， 则 使 用 
系统 的 缺 省 设备 

e output_device_index - 输出 流 所 使 用 的 设备 的 编号 ， 如 果 不 指 定 的 话 ， 则 使 
用 系统 的 缺 省 设备 

e frames_per_buffer - 底层 的 缓存 的 块 的 大 小 ， 底 层 的 缓存 由 N 个 同样 大 小 的 块 
组 成 

e start - 指定 是 否 立即 开启 输入 输出 流 ， 缺 省 值 为 True 


录音 


从 声卡 读 取 数据 和 写 入 数据 一 样 简单 ， 下 面 我 们 用 一 个 简单 的 声音 监测 小 程序 来 展 
示 一 下 如 何 用 pyAudio 读 取 声 音 数据 。 


# -*- coding: utf-8 -*- 

from pyaudio import PyAudio, paInt16 
import numpy as np 

from datetime import datetime 

import wave 


# 将 data 中 的 数据 保存 到 名 为 filename 的 WAV 文 件 中 
def save_wave_file(filename, data): 

wf = wave.open(filename, 'wb') 

wf .setnchannels(1) 

wf .setsampwidth(2) 

wf .setframerate(SAMPLING_RATE) 

wf .writeframes("".join(data) ) 

wf .close() 


NUM_SAMPLES = 2000 
SAMPLING_RATE = 8000 
LEVEL = 1500 
COUNT_NUM = 20 
SAVE_LENGTH = 8 


pyAudio 内 部 缓存 的 块 的 大 小 

取样 频率 

声音 保存 的 疮 值 
NUM_SAMPLES 个 取样 之 内 出 现 COUNT_NUM 个 大 于 LEVE 
声音 记录 的 最 小 长 度 : SAVE_LENGTH * NUM_SAMPLE 
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# 开启 声音 输入 

pa = PyAudio() 

stream = pa.open(format=paInt16, channels=1, rate=SAMPLING_RATE, ir 
frames_per_buffer=NUM_SAMPLES) 


save_count = 0 
save_buffer = [] 


while True: 
# 读 入 NUM_SAMPLES 个 取样 


string _audio_data = stream.read(NUM_SAMPLES) 
# 将 读 入 的 数据 转换 为 数组 
audio_data = np.fromstring(string_audio_data, dtype=np.short) 
# 计算 大 于 LEVEL 的 取样 的 个 数 
large_sample_count = np.sum( audio_data > LEVEL ) 
print np.max(audio_data) 
# 如 果 个 数 大 于 COUNT_NUM， 则 至 少 保存 SAVE_LENGTH 个 块 
if large_sample_ count > COUNT_NUM: 
save_count = SAVE_LENGTH 
else: 
save_count -= 1 


if save_count < 0: 
save_count = 0 


if save_count > 0: 
# 将 要 保存 的 数据 存放 到 save_buffer 中 
save_buffer.append( string_audio_data ) 
else: 
# 将 save_buffer 中 的 数据 写 入 WAV 文 件 ，WAV 文 件 的 文件 名 是 保存 的 时 刻 
if len(save buffer) > 0: 
filename = datetime.now().strftime("%Y-%m-%d_%H_%M_%S" 
save_wave_file(filename, save_buffer) 
save_buffer = [] 
print filename, "saved" 
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此 程序 一 开头 是 一 系列 的 全 局 变量 ， 用 来 配置 录音 的 一 些 参数 : 以 
SAMPLING_RATE 为 采样 频率 ， 每 次 读 入 一 块 有 NUM_SAMPLES 个 采样 的 数据 
块 ， 当 读 入 的 采样 数据 中 有 COUNT_NUM 个 值 大 于 LEVEL 的 取 祥 的 时 候 ， 将 数据 
保存 进 WAV 文 件 ， 一 旦 开始 保存 数据 ， 所 保存 的 数据 长 度 最 短 为 SAAVE_LENGTH 个 
块 。WAV 文 件 以 保存 时 的 时 刻 作为 文件 名 。 


从 声卡 读 入 的 数据 和 从 WAV 文 件 读 入 的 类 似 ， 都 是 二 进 制 数据 ， 由 于 我 们 用 
palnt16 格 式 (16bit 的 short 类 型 ) 保 存 采样 值 ， 因 此 将 它 自己 转换 为 dtype 为 np.short 
的 数组 。 





用 pyMedia 播 放 Mp3 


数字 信号 系统 


FIRIR Ra 
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为 FIR( 有 限 脉 冲 响 上 应) 滤波 器 ， 和 IIR( 无 限 脉 冲 响 应 ) 滤 波 器 两 种 。 
FIR 滤 波 器 根据 如 下 公式 进行 计算 : 
yim] = b[0)2[m] + b[1]a[m — 1] +---+ [Plain — P] 
IIR 滤 波 器 根据 如 下 公式 (直接 1 型 ) 进 行 计 算 : 
y[m] = b[0]2[m] + b[1]a2[m — 1] +--- + b[P)]2[m — P] 

— a{l}y[m — 1] — a[2]y[m — 2] —---—a[Q]y[m — Q] 
其 中 x 是 输入 信号 ， 数 组 a 和 b 是 滤波 器 的 系数 ，y 是 滤波 器 的 输出 。 我 们 可 以 把 FIR 
滤波 器 看 作 是 IIR 滤 波 器 的 一 种 特殊 情况 : 当 系数 a 都 为 0 时 就 从 IIR 滤 波 器 变 为 了 FIR 
滤波 器 了 。 
根据 FIR 滤 波 器 的 计算 公式 我 们 可 以 知道 ， 时 刻 m 的 输出 y[m] 由 时 刻 m 的 输入 x[m] 以 
及 之 前 的 输入 x[m-1] … x[m-P] 和 滤波 器 的 系数 b[0] ... b[P] 求 乘积 和 而 得 。 而 IIR 滤 波 
器 只 不 过 是 再 减 去 之 前 的 输出 y[m-1] ... y[m-Q] 和 系数 a[1] ... a[m-Q] 的 乘积 和 。 
总 之 ， 数 字 滤 波 器 的 计算 方法 并 不 复杂 ， 仅 仅 是 数组 对 应 元 素 的 乘积 和 求 和 而 已 。 
然而 其 计算 量 对 于 Python 来 说 是 相当 大 的 : 通常 FIR 滤 波 器 的 系数 长 度 都 上 百 ， 而 
CD 音质 的 数字 声音 信号 一 秒 钟 有 44100 个 取样 值 ， 假 设 滤波 器 的 长 度 是 100， 那 么 
一 秒 钟 需要 计算 4 百 万 次 以 上 的 乘积 和 加 法 。 这 对 于 Python 这 样 的 动态 语言 来 说 是 
很 困难 的 。 


因此 scipy 的 signal 库 中 提供 了 lfilter 画 数 完成 数字 小波 器 的 计算 工作 。 由 于 它 是 在 C 
语言 级 别 实现 的 ， 因 此 人 处理 速度 相当 快 : 


signal.lfilter(b, a, x, axis=-1, zi=None) 


其 中 的 b 和 a 是 滤波 器 的 系数 ，x 是 输入 。|filter 函 数 并 不 是 直接 使 用 上 面 的 IIR 滤 波 器 
计算 公式 进行 计算 ， 而 是 对 其 进行 了 如 下 的 变形 : 


y[m] = b[0]*x[m] + z[0,m-1] (1) 
z[0,m] = b[1]*x[m] + z[1,m-1] - a[1]*y[m] (2) 
2[n-3,m] b[n-2]*x[m] + z[n-2,m-1] - a[n-2]*y[m] 


z[n-2,m] b[n-1]*x[m] - a[n-1]*y[m] 


这 段 公 式 就 没有 那么 直 白 了 ， 但 是 只 需要 仔细 的 观察 一 下 就 不 难 发 现 ， 将 式 (2) 的 时 
间 变 为 m-1， 得 到 : 


z[0,m-1] = b[1]*x[m-1] + z[1,m-2] - a[1]*y[m-1] (3) 


将 其 带 和 到 式 (1) 中 ， 发 现 b[0]x1m7, b[1]}x[m-1], - af1]*y[m-1] 等 项 已 经 和 IIR 公 式 中 的 
一 致 ， 依 次 如 此 代入 下 去 最 后 得 到 的 公式 和 IIR 滤 波 器 的 公式 是 一 致 的 。 这 个 计算 公 
式 被 称 为 直接 2 型 。 


直接 1 型 的 公式 中 ， 为 了 计算 m 时 刻 的 输出 y[m]， 除 了 需要 m 时 刻 的 输入 x[m] 之 外 ， 
还 需要 x[m-1 到 x[m-P] 和 y[m-1] 到 y[m-Q]， 这 些 值 都 需要 被 作为 滤波 器 的 内 部 状态 
保存 起 来 ， 因 此 需要 保存 P+Q 个 数 。 而 根据 直接 2 型 的 公式 ， 只 需要 保存 n-1 个 数 
z[0] 到 z[n-2]， 其 中 n 为 max(len(a), len(b)) ， 即 max(P, Q)。 数 组 z 就 是 滤波 器 的 状 
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滤波 器 的 最 终 状 态 zf， 于 是 其 返回 值 为 (y, zf 和)， 如 果 zi 为 None 的 话 ， 那 么 只 返回 滤波 
器 的 输出 y。 


当 使 用 Ifilter 对 很 长 的 输入 进行 滤波 计算 时 ， 不 能 一 次 把 数据 都 读 入 到 数组 Xx 中 ， 
此 需要 对 数据 进行 分 段 滤 波 ， 这 时 就 需要 将 上 一 次 调用 lfilter 时 返回 的 数组 zf， 传 递 
到 下 一 次 |filter 画 数 调用 。 下 面 的 程序 演示 了 这 种 分 段 滤波 的 方法 : 


# -*- coding: utf-8 -*- 
import scipy.signal as signal 
import numpy as np 

import pylab as pl 


某 个 均衡 滤波 器 的 参数 
np.array([1.0, -1.947463016918843, 0.9555873701383931]) 
np.array([0.9833716591860479, -1.947463016918843, 0.9722157109! 


# 
a= 
D= 
# 44.1kHz， 1M MIR 

t = np.arange(0, 0.5, 1/44100.0) 

X= Signal.chirp(t, f0=10, t1 = 0.5, f1=1000.0) 


# 直接 一 次 计算 滤波 器 的 输出 

y = signal.lfilter(b, a, x) 
# 将 输入 信号 分 为 50 个 数据 一 组 
x2 = x.reshape((-1,50)) 


# 滤波 器 的 初始 状态 为 0， 长 度 是 滤波 器 系数 长 度 -1 
z = np.zeros(max(len(a),len(b))-1, dtype=np.float) 
y2 = [] # 保存 输出 的 列表 


for tx in x2: 
# 对 每 段 信号 进行 滤波 ， 并 更 新 滤波 器 的 状态 z 
ty, z = signal.lfilter(b, a, tx, zi=z) 
# 将 输出 添加 到 输出 列表 中 
y2.append(ty) 


将 输出 y2 转 换 为 一 维 数组 
np.array(y2) 


# 
y2 
y2 y2.reshape((-1, )) 


# 输出 y 和 y2 之 间 的 误差 

print np.sum((y-y2)**2) 

# 绘图 

pl.plot(t, y, t, y2) 

pl.show( ) 
a 
程序 所 输出 的 误差 为 0， 经 过 滤波 器 之 后 的 频率 扫描 波形 如 下 图 所 示 : 
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0.1 0.2 0.3 0.4 0.5 
经 过 均衡 滤波 器 之 后 的 频率 扫描 波形 


此 程序 中 使 用 的 IIR 滤 波 器 的 系数 为 二 次 均衡 滤波 器 的 系数 ， 其 系数 的 设计 算法 将 在 
下 节 进 行 介 绍 。 为 了 观察 滤波 器 的 频率 特性 ， 我 们 让 它 对 频率 打 描 波 进行 处理 。 分 
别 采用 一 次 滤波 和 分 段 滤 波 两 种 方式 调用 |filter 画 数 ， 我 们 看 到 两 个 结果 完全 一 样 。 
使 用 分 段 滤波 结合 pyaudio 库 ， 我 们 很 容易 写 出 对 声卡 采集 的 连续 的 声音 信号 进行 
滤波 并 输出 的 实时 滤波 程序 。 


如 果 将 一 个 脉冲 信号 输入 到 滤波 器 中 ， 所 得 到 的 输出 被 称 为 滤波 器 的 其 脉冲 响应 。 
所 谓 脉冲 信号 就 是 在 时 刻 0 为 1， 其 余 时 刻 均 为 0 的 信号 。 根 据 FIR 滤 波 器 的 公式 ， 

FIR 滤 波 器 的 脉冲 响应 就 是 滤波 器 的 系数 。 而 IIR 滤 波 器 的 脉冲 响应 就 不 是 很 直观 

了 ， 下 面 使 用 lfilter 计 算 IIR 滤 波 器 的 脉冲 响应 ， 其 中 的 IIR 滤 波 器 的 系数 和 前 面 的 一 
样 (在 IPython 或 者 Spyder 中 运行 上 面 的 程序 之 后 ， 再 输入 下 面 的 程序 ) 


>>> impulse = np.zeros(1000, dtype=np. float) 
>>> impulse[0] = 1 

>>> h = signal.lfilter(b, a, impulse) 

>>> h[-1] 

-4.2666825205952273e-12 


二 次 IIR 均 衡器 的 脉冲 响应 
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均衡 滤波 器 的 脉冲 响应 
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如 果 你 观察 一 下 h 的 具体 的 值 就 会 发 现 随 着 时 间 的 推移 ，h 越 来 越 小 ， 但 是 始终 不 会 
为 0， 其 脉冲 响应 是 无 限 长 度 的 ， 因 此 才 被 称 作 无 限 脉冲 响应 滤波 器 。 如 果 我 们 将 h 
当 作 FIR 滤 波 器 的 系数 对 信号 x 进行 滤波 的 话 ， 得 到 的 结果 


>>> y3 = signal.lfilter(h, 1, x) 
>>> np.sum((y-y3)**2) 
3.7835244127856444e-17 


显然 由 于 h 是 逐渐 衰减 的 ， 只 要 我 们 测量 足够 长 的 脉冲 响应 ， 
够 精 确 地 模拟 IIR 滤 波 器 。 下 图 显示 的 是 误差 和 FIR 滤 波 器 的 长 度 之 间 的 关系 。 显 然 
由 于 IIR 滤 波 器 的 脉冲 响应 是 呈 指 数 衰 减 的 ， 因 此 精度 随 着 长 度 呈 指数 增加 ， ee! 
Y 轴 是 对 数 坐 标 。 


FIR 模 拟 IIR 的 误差 
© 


a ð 200 400 680 800 1900 12090 


脉 ;中 响应 长 度 


随 着 FIR 小 波 器 的 长 度 的 增加 误差 呈 指 数 减 小 
此 图 的 计算 程序 如 下 ， 注 意 用 lfilter 计 算 FIR 滤 波 器 时 ， 设 置 参数 a 的 值 为 1 : 


# -*- coding: utf-8 -*- 
import scipy.signal as signal 
import numpy as np 

import pylab as pl 


# 某 个 均衡 滤波 器 的 参数 
np.array([1.0, -1.947463016918843, 0.9555873701383931]) 
np.array([0.9833716591860479, -1.947463016918843, 0.9722157109! 


O w 


# 44.1kHz, 1 AIR 

t = np.arange(0, 0.5, 1/44100.0) 

X= Signal.chirp(t, f0=10, t1 = 0.5, f1=1000.0) 
y = signal.lfilter(b, a, x) 

ns = range(10, 1100, 100) 

err = [] 


for n in ns: 
# 计算 脉冲 响应 
impulse = np.zeros(n, dtype=np.float ) 
impulse[0] = 1 
h = signal.lfilter(b, a, impulse) 


# 直接 FIR 滤 波 器 的 输出 
y2 = signal.lfilter(h, 1, x) 


# 输出 y 和 y2 之 间 的 误差 
err.append(np.sum((y-y2)**2)) 


# 绘图 
pl.figure(figsize=(8,4)) 
pl.semilogy(ns , err, "-o") 
pl.xlabel(u" 脉 冲 响应 长 度 ") 
pl.ylabel(u"FIR 模 拟 IIR 的 误差 ") 
pl. show() 





FIR 滤 波 器 设计 


理想 的 低 通 滤波 器 频率 响应 如 下 图 所 示 : 


y 频率 fc fs/2 


理想 低 通 滤波 器 的 频率 响应 


其 中 fc 为 阻 带 频率 。 通 常 为 了 计算 方便 ， 将 取样 频率 正规 化 为 1。 于 是 f 的 含义 就 
是 每 个 取样 点 所 包含 的 信号 的 周期 数 ， 例 如 0.1 表 示 每 个 取样 点 包含 0.1 个 周期 ， 即 
一 个 周期 有 10 个 取样 点 。 根 据 离散 传 立 叶 变 换 的 公式 可 以 求 出 此 理想 低 通 滤波 器 的 
脉冲 响应 为 : 


Nideat(™) - ae = 2f.sinc(2f.n) 
其 中 m 为 抽 无 穷 到 正 无 穷 的 整数 。 显 然 此 脉冲 响应 不 但 无 限 长 ， 而 且 不 满足 因果 


律 ， 因 为 输入 信号 在 0 时 刻 出 现 的 脉冲 ， 而 输出 信号 却 在 0 时 刻 之 前 就 有 值 了 。 


这 样 的 脉冲 响应 当然 无 法 用 FIR 滤 波 器 实现 ， 一 个 最 直观 的 近似 方法 就 是 取 /uaaeu 中 
O<=n<L 的 L 个 值 当 作 低 通 FIR 滤 波 器 的 系数 。 下 面 的 程序 计算 此 低 通 滤波 器 的 频率 
响应 : 


# -*- coding: utf-8 -*- 
import scipy.signal as signal 
import numpy as np 

import pylab as pl 


def h_ideal(n, fc): 
return 2*fc*np.sinc(2*fc*np.arange(-n, n, 1.0)) 


b = h_ideal(30, 0.25) 
w, h = signal.freqz(b) 


pl.figure(figsize=(8,3)) 
pl.plot(w/2/np.pi, 20*np.logi0(np.abs(h))) 
pl.xlabel(u" 正 规 化 频率 周期 /取样 " ) 
pl.ylabel(u" 幅 值 (dB)") 

pl. show() 


8.2 8.3 
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截取 sinc 函 数 正 时 间 部 分 作为 脉冲 响应 的 低 通 滤波 器 


用 freqz 计 算 频 率 响 应 
freqz 用 于 计算 数字 滤波 器 的 频率 响应 ， 它 的 调用 方式 如 下 : 


freqz(b, a=1, worN=None, whole=0, plot=None) 


其 中 b 和 a 是 滤波 器 的 系数 ，worN 为 所 计算 的 频率 点 数 ，whole 为 0 表示 计算 频率 的 
上 限 为 pi，whole 为 1 表示 计算 频率 的 上 限 为 2*pi。 


它 返 回 一 个 组 元 (wh) ， 其 中 w 为 所 有 计算 了 响应 的 频率 数组 ， 其 值 为 正规 化 的 圆 
频率 ， 因 此 通过 W/(2*pi) 可 以 计算 出 对 应 的 正规 化 频率 。h 是 一 个 复数 数组 ， 它 表示 
滤波 器 系统 在 每 个 对 应 的 频率 点 的 响应 。 复 数 的 幅 值 表示 滤波 器 的 增益 特性 ， 相 角 
表示 滤波 器 的 相位 特性 。 


程序 中 使 用 freqz 计 算 滤 波 器 的 频率 响应 ， 并 用 20*np.log10(np.abs(h)) 计算 h 以 dB 
衡量 的 幅 值 。 


用 firwin 设 计 滤 波 器 


显然 此 频率 响应 和 理想 的 低 通 滤波 器 相差 甚 远 ， 并 且 即 使 增加 FIR 滤 波 器 的 系数 也 
没有 作用 。 因 为 我 们 舍弃 了 n<0 的 那 一 半 系 数 ， 而 这 些 系数 有 着 相当 大 的 影响 ， 
此 只 截取 n>=0 的 部 分 是 不 够 的 ， 如 果 我 们 将 n<0 的 那 一 半 系 数 也 添加 进 滤 波 器 的 
话 ， 得 到 的 频率 响应 将 会 有 很 大 的 改善 。 如 下 重新 定义 h_ideal 辑 数 ， 它 返回 Nigea 
中 -n 到 n 之 间 的 系数 : 


def h_ideal(n, fc): 
return 2*fc*np.sinc(2*fc*np.arange(-n, n, 1.0)) 


下 面 是 添加 n<0 系 数 之 后 的 频率 响应 : 


0.2 2.3 
正规 化 频率 周期 /取样 
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这 样 做 虽然 改善 了 频率 响应 ， 但 是 给 系统 带 来 了 许多 延 时 ， 为 了 频率 响应 更 好 必须 
增加 滤波 器 的 点 数 ， 然 而 为 了 减少 延 时 ， 必 须 减 少 点 数 ， 为 了 解决 这 个 矛盾 ， 我 们 
给 系数 乘 上 一 个 窗 函 数 ， 让 它 快速 收 化。 


SciPy 提 供 了 firwin 用 窗 画 数 设计 低 通 滤波 器 ，firwin 的 调用 形式 如 下 : 
firwin(N, cutoff, width=None, window='hamming' ) 


其 中 N 为 滤波 器 的 长 度 ; cutoff 为 以 有 /2 正规 化 的 频率 ; window 为 所 使 用 的 窗 画 数 。 


下 面 的 程序 用 firwin 设 计 低 通 滤波 器 ， 并 且 和 上 面 的 结果 进行 比较 ， 注 意 由 于 firwin 
的 cutoff 频 率 是 以 取样 频率 /2 正规 化 的 ， 因 此 它 是 前 面 所 介绍 的 fe 的 两 倍 。 


# -*- coding: utf-8 -*- 
import scipy.signal as signal 
import numpy as np 

import pylab as pl 


def h_ideal(n, fc): 
return 2*fc*np.sinc(2*fc*np.arange(-n, n, 1.0)) 


b = h_ideal(30, 0.25) # 以 fs 正规 化 的 频率 
b2 = signal.firwin(len(b), 0.5) # 以 fs/2 正 规 化 的 频率 


w, h = signal.freqz(b) 
w2, h2 = signal. freqz(b2) 


pl.figure(figsize=(8,6)) 

pl.subplot(211) 

pl.plot(w/2/np.pi, 20*np.logi0(np.abs(h)), label=u"h_ideal") 
pl.plot(w2/2/np.pi, 20*np.log10(np.abs(h2)), label=u"firwin" ) 
pl.xlabel(u" 正 规 化 频率 周期 /取样 " ) 

pl.ylabel(u" 幅 值 (dB)") 

pl.legend() 

pl.subplot(212) 

pl.plot(b, label=u"h_ideal") 

pl.plot(b2, label=u"firwin") 

pl.legend() 

pl.show( ) 


幅 值 (dB) 





firwin 使 用 窗 函 数 设 计 的 低 通 滤波 器 的 频率 响应 和 脉冲 响应 
使 用 firwin 函 数 设 计 的 滤波 器 并 不 是 最 优化 的 ， 为 了 实现 同样 效果 频率 响应 ， 还 存在 
长 度 更 短 的 FIR 滤 波 器 。 
用 remez 设 计 滤 波 器 
remez 辑 数 能 够 帮助 我 们 找到 更 优 的 滤波 器 系数 。remez 的 调用 形式 如 下 : 

remez(numtaps, bands, desired, 

weight=None, Hz=1, type='bandpass', maxiter=25, grid density=1t 

4 =a pres 
其 中 : 

e numtaps : 所 设计 的 FIR 滤 波 器 的 长 度 


e bands : 一 个 递增 序列 ， 它 包括 频率 响应 中 的 所 有 频带 的 边界 ， 其 值 在 0 到 
Hz/2 之 间 ， 如 果 参 数 Hz 为 缺 省 值 1 的 话 ， 那 么 可 以 把 它 当 作 是 以 取样 频率 正规 





化 的 频率 
e desired: 长 度 为 bands 的 一 半 的 增益 序列 ， 它 给 出 频率 响应 在 bands 中 的 每 个 
频带 的 增益 值 


e weight: 长 度 和 desired 一 样 的 权重 序列 ， 它 给 出 desired 中 的 每 个 增益 所 占 的 
权重 ， 即 给 出 desired 中 的 每 个 增益 的 重要 性 ， 值 越 大 表示 其 越 重 要 


e type : 'bandpass' 或 者 'differentiator， 本 书 只 介绍 type 为 'bandpass' 的 情况 
remez 算 法 


remez 是 一 种 迭代 算法 ， 它 能 够 找到 一 个 n 阶 多 项 式 ， 使 得 在 指定 的 区 间 中 此 多 项 式 
和 指定 函数 之 间 的 最 大 误差 最 小 化 。 由 于 FIR 滤 波 器 的 频率 响应 实际 上 是 一 个 多 项 
AKA (请 参考 下 节 内 容 ) ， 因 此 可 以 用 remez 算 法 进行 FIR 滤 波 器 系数 设计 。 


remez 返 回 经 过 remez 算 法 最 优化 之 后 的 FIR 滤 波 器 的 系数 。 此 系数 和 用 firwin 所 设 
计 的 结果 一 样 是 对 称 的 。 S i aal 所 设计 的 滤波 器 对 于 取样 频率 /2 的 
响应 为 0， 因 此 无 法 设计 出 长 度 为 偶数 的 高 通 滤波 器 。 


下 面 的 程序 演示 通过 remez 设 计 高 通 滤 波 器 : 


# -*- coding: utf-8 -*- 
import scipy.signal as signal 
import numpy as np 

import pylab as pl 


for length in [11, 31, 51, 101, 201]: 
b = signal.remez(length, (0, 0.18, 0.2, 0.50), (0.01, 1)) 
w, h = signal.freqz(b, 1) 
pl.plot(w/2/np.pi, 20*np.logi0(np.abs(h)), label=str(length) ) 
pl.legend() 
pl.xlabel(u" 正 规 化 频率 周期 /取样 " ) 
pl.ylabel(u" 幅 值 (dB)") 
pl.title(u"remez 设 计 高 通 滤 波 器 - 滤波 器 长 度 和 频 响 的 关系 ") 
pl. show() 


程序 中 ，remez 函 数 的 bands 参 数 给 出 两 个 频带 (以 取样 频率 正规 化 ) : 0 到 0.18 和 0.2 
到 0.5， 而 desired 给 出 两 个 频带 的 增益 分 别 为 0.01 和 1， 因 此 它 所 设计 的 是 一 个 通 带 
频率 为 0.2、 阻 带 增益 为 -40dB 的 高 通 Rae, 


此 程序 显示 出 滤波 器 长 度 和 频率 响应 之 间 存 在 如 下 关系 ， 可 以 看 出 滤波 器 越 长 ， 频 
率 响应 越 接近 设计 值 : 


remez 设 计 高 通 滤波 器 - 滤波 器 长 度 和 频 响 的 关系 


| 
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remez 设 计 的 高 通 滤波 器 ， 长 度 越 长 频率 响应 越 接 近 设 计 值 
下 图 显示 权 值 和 频率 响应 之 间 的 关系 ， 图 中 的 滤波 器 长 度 为 101。 我 们 注意 到 ， 当 
权 值 为 1, 0.01( 红 色 曲 线 ) 时 ， 两 个 频带 的 增益 拌 动 量 相 同 ， 这 个 权 值 正好 和 增益 
desired 的 设置 相反 。 这 时 因为 缺 省 情况 下 ， 增 益 越 大 的 频带 的 频率 响应 要 求 越 精 
确 ， 而 当权 值 和 增益 的 乘积 相等 时 ， 频 率 响 应 的 误差 也 就 相同 了 。 


remez 设 计 高 通 滤波 器 - 权 值 和 频 响 的 关系 
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正规 化 频率 周期 /取样 


remez 设 计 滤 波 器 时 权 值 影响 频率 响应 


滤波 器 级 联 


假设 有 两 个 滤波 器 h1 和 h2， 我 们 将 h1 的 输出 输入 到 h2， 这 样 得 到 的 滤波 器 称 为 h1 
和 h2 的 级 联 。 级 联 后 的 滤波 器 的 脉冲 响应 为 h1 和 h2 的 脉冲 响应 的 耸 积 ， 而 其 频率 响 
应 为 两 个 滤波 器 的 频率 响应 的 乘积 。 


下 面 的 程序 先 用 remez 分 别 设计 一 个 高 通 滤波 器 h1 和 一 个 低 通 滤波 器 h2， 然 后 通过 
谷 积 计算 出 它们 的 级 联 滤波 器 h3 的 系数 : 


# -*- coding: utf-8 -*- 
import scipy.signal as signal 
import numpy as np 

import pylab as pl 


h1 = signal.remez(201, (©, 0.18, 0.2, 0.50), (0.01, 1)) 
h2 = signal.remez(201, (0, 0.38, 0.4, 0.50), (1, 0.01)) 
h3 = np.convolve(hi, h2) 


w, h = signal.freqz(h3, 1) 
pl.plot(w/2/np.pi, 20*np.1logi0(np.abs(h))) 


pl.legend( ) 
pl.xlabel(u" 正 规 化 频率 周期 /取样 " ) 
pl.ylabel(u" 幅 值 (dB)") 
pl.title(u" 低 通 和 高 通 级 联 为 带 通 滤波 器 " ) 
pl.show( ) 

最 后 使 用 freqz 函 数 计算 h3 的 频率 响应 : 


低 通 和 高 通 级 联 为 珊 通 滤波 器 
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低 通 和 高 通 滤波 器 级 联 之 后 是 带 通 滤波 器 
可 以 看 出 ， 所 得 到 的 是 一 个 带 通 滤波 器 。 

我 们 也 可 以 直接 用 remez 设 计 带 通 滤波 器 : 
>>> h4 = signal.remez(201, (©, 0.18, 0.2, 0.38, 0.4, 0.50), (0.01, 
a R 


如 果 你 观察 此 滤波 器 的 频率 响应 的 话 ， 发 现 它 和 h3 的 基本 一 致 ， 如 果 比 较 h3 和 h4 的 
话 ， 我 们 得 到 如 下 结果 : 








o 50 1900 150 200 250 300 350 400 
级 联 的 滤波 器 和 remz 设 计 的 带 通 滤波 器 的 脉冲 响应 近似 


可 以 看 出 虽然 h3 的 长 度 几乎 是 h4 的 两 倍 ， 但 是 由 于 它 的 许多 系数 都 接近 于 0， 因 此 
h3 和 h4 的 频率 响应 近 似 相 同 。 


lIR 滤 波 器 设计 

通常 在 设计 数字 |R 滤 波 器 时 ， 都 会 先 设计 一 个 对 应 的 模拟 滤波 器 ， 然 后 通过 双 线 性 
变换 将 模拟 滤波 器 转换 为 数字 滤波 器 。 这 意味 着 我 们 需要 在 s 复 平面 上 设计 滤波 器 

的 传递 函数 H(s)。 当 H(s) 的 所 有 的 极点 都 在 s 的 左 半 平 面 时 ， 滤 波 器 的 响应 是 稳定 

的 。 下 面 以 巴特 沃 斯 滤波 器 为 例 ， 说 明 这 一 设计 过 程 。 


巴特 沃 斯 低 通 滤波 器 
巴特 沃 斯 低 通 滤波 器 的 振幅 的 平方 和 频率 之 间 的 关系 可 以 用 如 下 公式 表示 : 
1 
| (jw)? = ——, 
1+ (2) 
其 中 n 为 滤波 器 的 阶 数 ，w 为 振幅 下 降 3dB 时 的 截止 频率 。 这 个 公式 很 容易 理解 : 
e 当 w 越 小 ， 振 幅 越 接近 于 1 
eo 当 w 越 大 ， 振 幅 越 接近 于 0 
e 随 着 n 的 增 大 ， 振 幅 接 近 于 1 或 者 0 的 速度 将 变 快 ， 即 n 越 大 ， 低 通 滤波 器 在 阻 频 
带 的 衰减 速度 将 越 快 
e 当 w = we 时 ， 振 幅 的 平方 为 112， 即 -3dB 


下 面 我 们 推导 出 巴特 沃 斯 低 通 滤波 器 的 传递 画 数 H(s)， 其 中 s = 4 十 Jw， 为 复数 平 
面 上 的 点 。 
由 于 当 豆 (s) 瑟 (一 s) = |H(jw)P， 因 此 将 % = s/j 带 入 到 巴特 沃 斯 低 通 江波 器 的 振幅 
平方 公式 中 可 以 得 到 : 

Go? 


1+ (=F) 


H(s)H(—s) = 


此 公式 有 2n 个 极点 ， 其 中 n 个 在 左 半 和 平面 ，n 个 在 右 半 平面 ， 由 于 H(s) 必 须 是 稳定 


的 ， 因 此 左 半 和 平面 的 n 的 极点 属于 H(s)。 
最 后 得 到 的 传递 丁 数 为 : 


1 
“HE i(8 — Skj ) [we 
其 中 sk 为 左 半 平 面 上 的 极点 : 
7(2k+n—l}” 
Sk EWE mo kS ER eS 


下 面 的 程序 绘制 6、7 阶 巴特 沃 斯 低 通 滤波 器 的 S 复 平面 上 的 极点 : 


# -*- coding: utf-8 -*- 

from scipy import signal 
import numpy as np 

import matplotlib.pyplot as pl 


pl.figure(figsize=(5,5)) 


b, a = signal.butter(6, 1.0, analog=1) 
z,p,k = signal.tf2zpk(b, a) 


pl.plot(np.real(p)，np.imag(p)，'^'，1label=u"6 阶 巴特 沃 斯 极点 ") 


b, a = signal.butter(7, 1.0, analog=1) 
z,p,k = signal.tf2zpk(b, a) 


pl.plot(np.real(p)，np.imag(p)，'s'，1label=u"7 阶 巴特 沃 斯 极点 ") 


pl.axis("equal") 
pl.legend(loc="center right") 
pl.show( ) 


EFA, fe AbutterNMikit BRAM Res, RAR RCRiTHNEMS eR 


a 为 了 设计 模拟 滤波 器 ， 需 要 传递 关键 字 参 数 analog=1。 
系数 之 后 ， 通 过 tf2zpk 画 数 将 它们 转换 为 需 点 和 极点 : 


a+ 76 
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巴特 沃 斯 低 通 滤波 器 在 S 复 平面 上 的 极点 分 布 


双 线 性 变换 


有 了 连续 时 间 的 传递 画 数 H(s)， 下 一 步 就 是 如 何 将 它 转换 为 离散 时 间 的 传递 画 数 
H(z)。 转 换 的 方法 有 几 种 ， 其 中 最 常用 的 是 双 线 性 变换 ， 其 变换 公式 为 : 


其 中 T 为 离散 时 间 的 取样 周期 。 双 线性 变换 公式 的 推导 过 程 请 参考 下 面 的 链接 : 
双 线 性 变换 公式 推导 : http:/en.wikipedia.org/wiki/Bilinear transform 


双 线 性 变换 实际 上 是 s 复 平面 和 z 复 平面 上 的 点 的 映射 变换 ， 他 将 s 复 平面 上 的 坚 线 
变换 成 z 复 平面 上 的 圆 ， 而 s 复 平面 上 的 Y 轴 对 应 于 z 复 平面 上 的 单位 圆 。 下 面 的 程序 
演示 了 这 一 对 应 关系 : 


# -*- coding: utf-8 -*- 
import numpy as np 
import pylab as pl 


def stoz(s): 
将 s 复 平面 映射 到 z 复 平面 
为 了 方便 起 见 ， 假 设 取样 周期 T=1 


return (2+s)/(2-s) 


def make_vline(x): 
return x + 1j*np.linspace(-100.0,100.0, 20000) 


fig = pl.figure(figsize=(7,3)) 
axs = pl.subplot(121) 
axz = pl.subplot(122) 
for x in np.arange(-3, 4, 1): 
s = make_vline(x) 
z = stoz(s) 
axs.plot(np.real(s), np.imag(s)) 


axz.plot(np.real(z), np.imag(z)) 


axs.set_xlim(-4,4) 
axz.axis("equal") 
axz.set_ylim(-3,3) 


pl.show( ) 


fe Fe PAY stozes We ts A He ZAR RAT, ARB xt LRA MARE RRA 
变形 即 可 得 到 ， 这 里 为 了 方便 起 见 ， 假 设 取 祥 周期 T=1。 
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双 线 性 变换 将 s 平 面 ( 左 图 ) 上 的 坚 线 变 换 为 z 平 面 上 的 圆 ( 右 图 ) 


通过 双 线性 变换 之 后 ， 渡 波 器 的 频率 响应 会 发 生变 化 。 在 下 一 节 中 我 们 会 介绍 ， 离 
散 时 间 的 滤波 器 的 频率 响应 是 将 其 传递 事 数 H(z) 用 z = el TTB. HH i AB 
双 线 性 变换 公式 得 到 : 

ee | 2 elet =] 2 eleT/2 -_ eel /2 


J 9 
— aed 三 i tan wT 2 
Tz+1 了 eyeT 十 1 T ei eT /2 4 e-jwT /2 IT \ / 
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下 面 让 我 们 用 程序 来 验证 这 个 频率 转换 公式 。 首 先 我 们 载 人 所 需要 的 库 ， 并 且 定 义 
离散 时 间 的 取样 频率 fs 为 8kKHz， 设 计 的 巴特 沃 斯 低 通 滤波 器 通 带 截至 频率 为 1kHz : 


>>> from scipy import signal 
>>> from numpy import * 

>>> fs = 8000.0 

>>> f = 1000.0 


下 面 使 用 butter 函 数 设 计 一 个 3 阶 的 巴特 沃 斯 滤波 器 ， 注 意 关 键 字 参数 analog=1， 表 
示 设 计 连 续 时 间 传 递 画 数 H(s) 的 系数 ， 由 于 通 带 频率 参数 为 圆 频率 ， 因 此 需要 乘 以 
2*pi : 


>>> b, a = signal.butter(3, 2*pi*f, analog=1) 


模拟 滤波 器 的 系数 b 和 a 和 H(s) 的 关系 


假设 p 和 a 的 长 度 分 别 为 M 和 N， 模 拟 滤波 器 的 系数 中 b[0] 为 分 子 中 sx- ，b[-1] 和 af[-1] 
为 分 子 分 母 的 常数 项 的 系数 ， 即 : 


f{ — WT mea k 
; bos ™ 1 十 bıs™ “十 ... 十 Dr-1 
H(s) = Se wa SMSO. E a 
ays” ays e Eee op ayes 


SRSA FAME X RA Mbilinear, FRAU e A A ANEBRNAAM, UX 
键 字 参数 fs 指定 取样 频率 : 


>>> b2, a2 = signal.bilinear(b,a, fs=fs) 


#2 FIA Afroz EAFA RRA AR A, A TENRA, R 
们 通过 worN 关 键 字 参 数 让 它 计 算 10000 点 的 频率 响应 : 


>>> w2, h2 = signal.freqz(b2,a2,worN=1000 ) 


接 下 来 将 h2 转 换 为 增益 ， 并 且 找 到 增益 为 -3dB( 精 确 值 为 10/og70(0.5)) 时 所 对 应 的 
正规 化 圆 频率 w 的 下 标 idqx，w/(2pi)*fs 就 是 其 对 应 的 实际 频率 值 : 


>>> p2 = 20*1l0g10(abs(h2) ) 

>>> idx = argmin(abs(p2-10*1lo0g10(0.5))) 
>>> w2[idx]/2/pi*8000 

952.8 


通过 频率 转换 公式 得 到 的 频率 为 : 


>>> 2*fs*arctan(2*pi*f/2/fs) /2/pi 
952.8840223 


S mtt Ascipy.signal #i£ i+ IRR RA RAMA, AA EERE RA i+ 
数 缺 省 都 是 直接 设计 数字 滤波 器 。 这 些 画 数 设 计数 字 滤 波 器 时 采用 的 取样 频率 为 
2， 即 以 香农 频率 fs/2 为 1 进行 正规 化 。 因 此 要 设计 取样 频率 为 ffS、 通 带 频 率 为 {的 滤 
波 器 需要 将 通 带 频率 正规 化 为 ff(fs/2)， 下 面 调 用 butter 本 数 设计 数字 低 通 滤波 器 ， 这 
里 使 用 上 述 计算 所 得 的 通 带 频率 : 


>>> b3,a3 = signal.butter(3, 952.8840223/(fs/2)) 
>>> sum(abs(b3-b2) ) 

1.3226225670237568e-13 

>>> sum(abs(a3-a2) ) 

7.0876637892069994e-13 


数字 滤波 器 的 系数 p 和 a 和 H(z) 的 关系 


假设 p 和 a 的 长 度 分 别 为 M 和 N， 数 字 滤 波 器 的 系数 中 b[0] 和 al[0] 分 别 为 分 子 分 母 中 常 
数 项 的 系数 ，a[-1] 为 分 母 中 z-(- 的 系数 ， 即 : 


e bo 十 biz-! OA by-127 Y 


ay — a,z7! 十 ... 十 ay—y27 (8 1) 


H(s) 


ASM ERAS RAb3Mla34-F LK it bilinearWAit+ SWKAb2Aa2eZ—BWM. 
在 signal 库 设计 数字 滤波 器 时 ， 其 内 部 会 先 通过 频率 转换 公式 对 频率 进行 转换 ， 然 
后 设计 连续 时 间 的 传递 画 数 系数 ， 最 后 通过 bilinear 函 数 进行 系数 转换 。 有 闪 趣 的 读 
者 可 以 查看 signal.iirfilter 函 数 的 源 代码 。 


滤波 器 的 频带 转换 


只 要 知道 了 低 通 滤波 器 的 传递 男 数 H(s)， 就 很 容易 利用 变量 替换 设计 出 同样 阶 数 的 
高 通 、 带 通 或 者 其 它 通 带 频 率 的 低 通 滤波 器 。 让 我 们 来 看 看 低 通 滤波 器 的 变换 。 


ee ee ne ee E 
通 滤 流 器 : 


>>> b, a = signal.butter(2, 1.0, analog=1) 
>>> np.real(b) 


array([ 1.]) 
>>> np.real(a) 


array([ 1\. , 1.41421356, 1\. ]) 
1 
H(s) = 29. (ee AAS Ler 
s* + 1.41428 + 1 
为 了 让 它 变 为 通 带 频率 为 we 的 低 通 滤波 器 ， 只 需要 进行 如 下 蔡 换 : 


c 


由 于 当 s = J 时 振幅 下 降 3dB 的 ， 而 s = Jwe FIE3dB. F238 R AR A 2E 
的 2 阶 低 通 滤波 器 的 系数 : 


>>> b2，a2 = signal.butter(2, 2.0, analog=1) 
>>> np.real(b2) 


array([ 4.]) 
>>> np.real(a2) 
array([ 1\. , 2.82842712, 4N， ] ) 


可 以 看 出 将 * > nena 时 到 这 些 系 数 。 


We 
s 一 一 
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此 蔡 代 公式 很 容易 理解 : 


。 若 w 为 0， 则 替代 之 后 的 频率 为 无 穷 大 ， 而 低 通 滤波 器 无 穷 大 义 的 频率 响应 为 
0， 即 转换 之 后 的 滤波 器 在 0 处 的 频率 响应 为 0 ; 

© 若 ww 为 无 穷 大 ， 则 替代 之 后 的 频率 为 0， 因 此 转换 之 后 的 滤波 器 在 无 穷 大 处 频率 
响应 为 1。 


下 面 设计 通 带 频率 为 1 弧度 / 秒 的 高 通 滤波 器 : 


>>> b3,a3 = signal.butter(2,1.0, btype="high", analog=1) 
>>> np.real(b3) 

array([ 1., ©., 90.]) 

>>> np.real(a3) 

array([ 1\. , 1.41421356, 1\. 1) 


可 以 看 出 这 些 系 数 是 将 sz 之 后 得 到 的 。 


低 通 滤波 器 还 可 以 转换 为 带 通 滤波 器 ， 这 可 能 有 点 难以 理解 ， 让 我 们 先 来 看 看 蔡 代 
公式 ， 假 设 带 通 滤波 器 的 高 低 通 带 频率 为 w1 : 


wo 8 wo 
ee a 
Aw (= 8 ) 
其 中 “0 = VY%1%2。wo 则 是 通 带 的 中 心 频率 。 
让 我 们 通过 下 面 的 程序 来 研究 一 下 为 何 这 种 替代 能 够 将 低 通 映射 为 带 通 滤波 器 : 


# -*- coding: utf-8 -*- 
import numpy as np 

from scipy import signal 
import pylab as pl 


b, a = signal.butter(2, 1.0, analog=1) 


# DA - > FAIS FR 


w1 = 1.0 # 低 通 带 频 率 

w2 = 2.0 # 高 通 带 频率 

dw = w2 - wi # 通 带 宽度 

wO = np.sqrt(wi*w2) # 通 带 中 心 频率 


# 产生 10**-2 到 10**2 的 频率 点 
w = np.logspace(-2, 2, 1000) 


# 使 用 频率 变换 公式 计算 出 转换 之 后 的 频率 
nw = np.imag(w0/dw*(1j*w/wO + w0/(1j*w))) 


_, h = signal.freqs(b, a, worN=nw) 
h = 20*np.logi0(np.abs(h) ) 


pl.figure(figsize=(8,5)) 
pl.subplot(221) 

pl.semilogx(w, nw) # X 轴 使 用 Log 坐 标 绘图 
pl.xlabel(u" 变 换 前 圆 频率 (弧度 / 秒 )") 
pl.ylabel(u" 变 换 后 圆 频率 (弧度 / 秒 )") 
pl.subplot(222) 

pl.plot(h, nw) 
pl.xlabel(u" 低 通 滤 波 器 的 频率 响应 (dB)") 
pl.subplot(212) 

pl.semilogx(w, h) 
pl.xlabel(u" 变 换 前 圆 频率 (弧度 / 秒 )") 
pl.ylabel(u" 带 通 滤 波 器 的 频率 响应 (dB)") 
pl.subplots_adjust(wspace=0.3, hspace=0.3, top=0.95, bottom=0.14) 


print "center:", w[np.argmin(np.abs(nw) ) ] 
pl.show( ) 


BE ss 
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b, a = Ssignal.butter(2, 1.0, analog=1) 


我 们 要 将 其 转换 为 通 带 频率 为 w1=1 到 w2=2 的 带 通 滤波 器 : 


# 低 通 -> 带 通 的 频率 变换 函数 
w1 = 1.0 # 低 通 带 频 率 
w2 = 2.0 # 高 通 带 频率 
dw = w2 - wi # 通 带 带宽 


= 
© 


np.sqrt(w1*w2) # 通 带 中 心 频 率 


假设 我 们 关心 的 频率 响应 的 频率 段 为 0.01 到 100， 使 用 logspace 本 数 产生 一 个 这 个 
区 间 的 等 比 数列 w : 


w = np.logspace(-2, 2, 1000) 


通过 带 通 频 率 转换 公式 将 其 转换 为 新 的 频率 序列 nw : 


nw = np.imag(wO0/dw*(1j*w/wO + w0/(1j*w))) 


使 用 此 新 的 频率 序列 nw 计 算出 每 个 频率 点 对 应 的 低 通 滤波 器 的 频率 响应 ， 注 意 我 们 
通过 WorN 关 键 字 传输 让 freqs 辑 数 计算 指定 频率 的 频率 响应 : 


_, h = signal.freqs(b, a, worN=nw) 
h = 20*np.logi0(np.abs(h) ) 


下 面 的 语句 就 绘制 出 w 和 h 的 关系 ， 也 就 是 带 通 滤波 器 的 频率 响应 : 


pl.semilogx(w, h) 


下 图 是 程序 的 输出 。 其 中 左上 图 绘制 的 是 频率 转换 画 数 ， 右 上 图 绘制 的 是 低 通 滤波 
器 的 频率 响应 (X 轴 为 响应 ，Y 轴 为 频率 )， 最 下 面 绘制 的 是 最 终 的 带 通 滤波 器 的 频率 
响应 。 
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使 用 频率 转换 公式 将 低 通 变 为 带 通 滤波 器 


由 于 带 通 的 频率 转换 公式 将 0 到 无 穷 大 映射 到 正 无 穷 到 负 无 穷 ， 而 低 通 滤波 器 在 正 

负 无 穷 处 的 频率 响应 都 为 0， AIL ARH AE eR” 带 通 滤波 器 。 而 
转换 之 后 的 频率 nw 为 0 的 点 所 对 应 的 原始 频率 就 是 带 通 滤波 器 的 中 心 频率 ， 此 人 处 的 
频率 响应 为 1， 下 面 的 程序 找到 nw 绝对 信 最 小 的 下 标 ， 并 输出 其 对 应 的 转换 前 的 频 
率 ， 我 们 看 到 它 和 w0 是 一 致 的 : 


>>> print w[np.argmin(np.abs(nw) ) ] 
1.4130259906 


事实 上 ，scipy.signal 库 已 经 为 我 们 提供 了 频带 转换 的 轿 数 : 


Ip2Ip : 低 通 转 低 通 
Ip2hp : 低 通 转 高 通 
Ip2bp : 低 通 转 带 通 
Ip2bs : 低 通 转 带 阻 ， 转 带 阻 的 公式 留 给 读者 思考 


下 面 以 Ip2bp 为 例 简要 说 明 一 下 函数 的 用 法 ， 假 设 b,a 为 二 阶 标准 低 通 滤波 器 ， 下 面 
的 语句 将 转换 为 通 带 为 1 spe 甬 滤 波 器 ， 前 两 个 参数 为 滤波 器 的 系数 ， 后 两 
个 参数 分 别 为 中 心 频率 和 通 带 带宽 : 


>>> b, a = Signal.butter(2, 1.0, analog=1) 
>>> b3, a3 = Signal.lp2bp(b,a,np.sqrt(2), 1) 


我 们 也 可 以 直接 调用 butter 设 计 一 个 低 通 滤波 器 : 


>>> b4, a4 = signal.butter(2, [1,2], btype='bandpass', analog=1) 


两 个 结果 是 完全 一 致 的 : 


>>> np.all(b3==b4) 
True 
>>> np.all(a3==a4) 
True 


滤波 器 的 频率 响应 


前 面 的 许多 例子 中 都 使 用 函数 freqz 计 算 滤 波 器 的 频率 响应， 在 这 一 节 中 ， 让 我 们 来 
深入 研究 一 下 freqz 是 如 何 计算 频率 响应 的 。 在 IPython 中 输入 : 


def freqz(b, a=1, worN=None, whole=0, plot=None): 
b, a = map(atleast_id, (b,a)) 
if whole: 
lastpoint = 2*pi 
else: 
lastpoint = pi 
if worN is None: 
N = 512 
w = numpy.arange(0, lastpoint, lastpoint/N) 
elif isinstance(worN, types.IntType): 
N = worN 
w = numpy.arange(0, lastpoint, lastpoint/N) 
else: 
w = worN 
w = atleast_id(w) 
zmi = exp(-1j*w) 
h = polyval(b[::-1], zmi) / polyval(a[::-1], zm1) 
if not plot is None: 
plot(w, h) 
return w, h 


研究 一 下 这 段 代 码 ， 不 难 发 现 真 正 的 计算 频率 响应 的 代码 可 以 用 如 下 3 行程 序 概 
括 : 


w = numpy.arange(0,pi, pi/N) 
zmi = exp(-1j*w) 
h = polyval(b[::-1], zmi) / polyval(a[::-1], zm1) 


为 了 弄 清 楚 为 什么 这 3 行 代码 能 够 计算 滤波 器 的 频率 响应 ， 让 我 们 先 来 学 习 一 下 相 
天 的 理论 知识 。 


JE Ras AY 3 Eom A ERAS AY fe BAM, RE RRHH ARAT : 
y[m] = b[0]2[m] + b[1]2[m — 1] +--- + b[P)]2[m — P] 
— a{l}y[m — 1] — a[2]y[m — 2] —---—a[Q]y[m — Q] 
RIZA ARAR, RAKSHA : 
Hla) = YO — Hol + eola] + ebla] + + + 2 MOP) 
X(z) 1+z-la[l] + z-2a[2] + --- + 2-NalQ] 


其 中 z 为 复数 平面 上 的 任意 一 点 。 当 z 为 单位 圆 上 的 点 ， 即 瑟 (w) 就 是 滤波 器 的 频率 
响应 。 ec’ 正好 绕 复 数 平面 单位 圆 转 一 圈 。 由 于 复数 平面 上 下 两 个 半 平 面 的 复数 存 
在 共 罗 关系 ， 因 此 通常 只 需要 求 上 半圆 的 频率 响应 ， 因 此 下 面 的 语句 将 上 半圆 等 分 
为 N 份 : 


w = numpy.arange(0,pi, pi/N) 


ABiTAWHE RY ASB 2, FERRER ASRA, FERRARO 
分 母 部 分 就 都 变 成 了 zm1 的 多 项 式 函 数 : 


zmi = exp(-1j*w) 


Ria tA A RARR it Bw sah : 


h = polyval(b[::-1], zmi) / polyval(a[::-1], zm1) 


polyval(p, x MA xt FRx PHNST Rite Api, ERARA T : 


pLO]*(x**N-1) + p[1]*(x**N-2) + ... + p[N-2]*x + p[N-1] 


由 于 滤波 器 系数 b 和 a 的 顺序 正好 和 polyval 的 多 项 式 系数 p 的 顺序 相反 ， 因 此 通过 数 
组 切片 运算 b[::-1] 业 滤波 器 的 系数 反 转 。 由 于 数组 zm1 中 的 值 都 为 复数 ， 因 此 所 得 
到 的 频率 响应 h 的 值 也 都 是 复数 。 复 数 的 幅 值 对 应 于 频率 响应 中 的 增益 特性 ， 而 其 
相 角 对 应 于 频率 响应 中 相位 特性 。 


freqz 中 在 Z 平 面 单位 加 上 所 取 的 点 是 等 距 线 性 的 ， 然 而 我 们 经 常 需要 在 绘制 频率 响 
应 图 表 时 要 求 频率 坐标 为 对 数 坐 标 ， 对 于 对 数 坐标 ， 等 距 的 频率 点 会 造成 低频 过 
球 ， 高 频 过 密 的 问题 ， 因 此 我 们 可 以 如 下 改造 freqz 函 数 ， 使 其 更 适合 计算 对 数 频 率 
坐标 的 频率 响应 。 


# -*- coding: utf-8 -*- 
import numpy as np 

import pylab as pl 

import scipy.signal as signal 


def logfreqz(b, a, f0, f1, fs, N): 

以 对 数 频 率 坐 标 计 算 滤 波 器 b, a 的 频率 响应 

fo, f1: 计算 频率 响应 的 开始 频率 和 结束 频率 

fs: 取样 频率 
w0, wi = np.log10(f0/fs*2*np.pi), np.log10(f1/fs*2*np.pi) 
# 不 包括 结束 频率 
w = np.logspace(w0, wi, N, endpoint=False) 
zmi = np.exp(-1j*w) 
h = np.polyval(b[::-1], zm1) / np.polyval(a[::-1], zm1) 
return w/2/np.pi*fs, h 


for n in range(1, 6): 
# 设计 n 阶 的 通 频 为 0.1*4000 = 400Hz 的 高 通 滤波 器 
b, a = signal.iirfilter(n, [0.1, 1]) 
f, h = logfreqz(b, a, 10.0, 4000.0, 8000.0, 400) 
gain = 20*np.log10(np.abs(h) ) 
pl.semilogx(f, gain, label="N=%s" % n) 
slope = (gain[100]-gain[10]) / (np.log2(f[100]) - np.log2(f[10- 
print "N=%s, slope=%s dB" % (n, Slope) 
pl.ylim(-100, 20) 
pl.xlabel(u" #3 (Hz)") 
pl.ylabel(u"3@#%(dB)") 
pl.legend() 
pl.show( ) 





FF F Mlogfreqz Hit BRB A blab ye RAs EO SIZ Nea, fsx EH 
频率 ，N 为 计算 的 点 数 。 首 先 通 过 f/fs2pi 将 实际 频率 转换 为 与 之 对 应 的 圆 频率 。 然 后 
通过 logspace 函 数 计 算 频 率 点 的 等 比 数列 。 最 后 和 freqz 一 样 通过 调用 polyval 计 算 频 
率 响 上 应， 返回 值 为 实际 频率 点 和 对 应 的 频率 响应 。 


接 下 来 通过 调用 iirfilter 设 计 5 个 不 同 阶 的 IIR 高 通 滤波 器 ， 通 频 为 0.1， 如 果 取 样 频 率 
为 8kHz 的 话 ， 那 么 实际 的 通 频 为 0.1*4kHz=400Hz。5 个 IIR 滤 波 器 的 增益 特性 如 下 
图 所 示 : 





107 10° 10* 
频率 (Hz) 
iirfilter 设 计 5 个 不 同 阶 的 IIR 高 通 滤波 器 


由 此 图 可 知 ， 随 着 IIR 小 波 器 的 阶 数 的 增加 ， 增 益 的 下 降 速 度 增加 ， 程 序 中 第 25 行 计 
算出 下 降 处 两 个 倍 频 之 间 的 增益 差 值 ， 其 结果 如 下 : 


# -*- coding: utf-8 -*- 


import scipy.signal as signal 
import pylab as pl 

import math 

import numpy as np 


def design_equalizer(freq, Q, gain, Fs): 
' 设计 二 次 均衡 滤波 器 的 系数 ' '， 
A = 10**(gain/40.0) 
wO = 2*math.pi*freq/Fs 
alpha = math.sin(w0) / 2 / Q 


bo = 1+ alpha * A 
b1 = -2*math.cos(w0) 
b2 = 1 - alpha * A 
a0 = 1 + alpha / A 
al = -2*math.cos(w0) 
a2 = 1 - alpha / A 


return [b0/a0,b1/a0,b2/a0], [1.0, ai/a0, a2/a0] 


pl.figure(figsize=(8,4)) 
for freq in [1000, 2000, 4000]: 
for q in [0.5, 1.0]: 
for p in [5, -5, -10]: 

b,a = design_equalizer(freq, q, p, 44100) 
w, h = signal.freqz(b, a) 
pl.semilogx(w/np.pi*44100, 20*np.log10(np.abs(h))) 

pl.xlim(100, 44100) 

pl.xlabel(u" 频 率 (Hz)") 

pl.ylabel(u" 振 幅 (dB)") 

pl.subplots_adjust(bottom=0.15) 

pl.show( ) 


使 用 上 节 介 绍 的 对 数 频 率 响 应 的 求法 以 及 TraitsUl 和 Chaco 等 界面 库 ， 我 们 可 以 设计 
如 下 界面 的 二 次 均衡 器 设计 程序 : 


& Equalizer Designer 


Load | Save | Export | 











y 
mm Gj Edel Gain(dB) 
Freq Q Gain 
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二 次 均衡 器 设计 工具 的 界面 


用 户 可 以 使 用 此 程序 添加 、 删 除 和 编辑 二 次 均衡 器 ， 并 且 即 时 查看 均衡 器 级 联 之 后 
的 频率 响应 。 完 整 的 程序 请 参照 : 二 次 均衡 器 设计 


ScrubberEditor 的 BUG 


如 果 界 面 中 的 ScrubberEditor 无 法 用 鼠标 拖 动 修改 的 话 ， 那 么 你 需要 修改 site- 
packages 目 录 下 的 scrubber_editor.py 文件 : 


# Establish the slider increment: 
increment = self.factory.increment 
if increment <= 0.0: 
if (low is None) or (high is None) or isinstance( low, int ): 
increment = 1.0 
else: 
increment = pow( 10, round( logi0( (high - low) / 100.0 ) ` 


self.increment = increment # ** 将 此 行 移出 if 作 用 域 
as — # 





FFT 演 示 程 序 


本 章 详细 介绍 如 何 综合 利用 之 前 所 学 习 的 numpy，traits，traitsUI 和 Chaco 等 多 个 
库 ， 编 写 一 个 FFT 演 示 程 序 。 此 程序 可 以 帮助 你 理解 FFT 是 如 何 将 时 域 信 号 转换 为 
频 域 信号 的 ， 在 开始 正式 的 程序 编写 之 前 ， 让 我 们 来 复习 一 下 有 关 FFT 变 换 的 知 
识 ， 如 果 你 没有 学 习 过 FFT， 现 在 就 是 一 个 不 错 的 学 习 机 会 。 


FFT 知 识 复习 


FFT 变 换 是 针对 一 组 数值 进行 运算 的 ， 这 组 数 的 长 度 N 必 须 是 2 的 整数 次 早 ， 例 如 
64, 128, 256 等 等 ; 数值 可 以 是 实数 也 可 以 是 复数 ， 通 常 我 们 的 时 域 信号 都 是 实 
数 ， 因 此 下 面 都 以 实数 为 例 。 我 们 可 以 把 这 一 组 实数 想像 成 对 某 个 连续 信号 按照 一 
定 取样 周期 进行 取样 而 得 来 ， 如 果 对 这 组 N 个 实数 值 进行 FFT 变 换 ， 将 得 到 一 个 有 N 
个 复数 的 数组 ， 我 们 称 此 复数 数组 为 频 域 信 号 ， 此 复数 数组 符合 如 下 规律 : 


e 下 标 为 0O 和 N/2 的 两 个 复数 的 虚数 部 分 为 0， 
e 下 标 为 j 和 N-i 的 两 个 复数 共 耗 ， 也 就 是 其 虚数 部 分 数值 相同 、 符 号 相反 。 


下 面 的 例子 演示 了 这 一 个 规律 ， 先 以 rand 随 机 产生 有 8 个 元 素 的 实数 数组 x， 然 后 用 
作对 其 运算 之 后 ， 观 察 其 结果 为 8 个 复数 ， 并 且 满 足 上 面 两 个 条 件 : 


>>> x = np.random.rand(8) 

>>> X 

array([ ©.15562099, 0.56862756, 0.54371949, 0.06354358, 0.60675 
0.78360968, ©.90116887, 0.1588846 ]) 

>>> xf = np.fft.fft(x) 


>>> xf 

array([ 3.78195634+0. j , -~0.53575962+0.57688097j, 
-Q@.68248579-1.12980906j, -0.36656155-0.13801778)j, 
0.63262552+0.j , -0.36656155+0.13801778j, 


-0.68248579+1.12980906j, -0.53575962-0.57688097j]) 
FFT 变 换 的 结果 可 以 通过 IFFT 变 换 〈 逆 FFT 变 换 ) 还 原 为 原来 的 值 : 





>>> np.fft.ifft(xf) 

array([ 0.15562099 +0.00000000e+00j, 0.56862756 +1.91940002e-16j, 
0.54371949 +1.24900090e-16j, 0.06354358 -2.33573365e-16j, 
0.60678158 +0.00000000e+00j, 0.78360968 +2.75206729e-16j, 
0.90116887 -1.24900090e-16j, 0.15888460 -2.33573365e-16j ] ) 


JE l 


注意 ifft 的 运算 结果 实际 上 是 和 x 相同 的 ， 由 于 浮 点 数 的 运算 误差 ， 出 现 了 一 些 非常 
小 的 虚数 部 分 。 


FFT 变 换 和 IFFT 变 换 并 没有 增加 或 者 减少 信号 的 数量 ， 如 果 你 仔细 数 一 下 的 话 ，x 
中 有 8 个 实数 数值 ， 而 xf 中 其 实 也 只 有 8 个 有 效 的 值 。 


计算 FFT 结 果 中 的 有 用 的 数值 


由 于 虚数 部 共 力 和 虚数 部 为 0 等 规律 ， 真 正 有 用 的 信息 保存 在 下 标 从 0 到 N/2 的 N/2+1 
个 虚数 中 ， 又 由 于 下 标 为 0 和 N/2 的 值 虚 数 部 分 为 0， 因 此 只 有 N 个 有 效 的 实数 值 。 


下 面 让 我 们 来 看 看 FFT 变 换 之 后 的 那些 复数 都 代表 什么 意思 。 


。 首先 下 标 为 0 的 实数 表示 了 时 域 信号 中 的 直流 成 分 的 多 少 
e 下 标 为 i 的 复数 a+b%j 表 示 时 域 信号 中 周期 为 Mi 个 取样 值 的 正弦 波 和 余弦 波 的 成 
分 的 多 少 ， 其 中 a 表 示 cos 波 形 的 成 分 ，b 表 示 sin 波 形 的 成 分 


让 我 们 通过 几 个 例子 来 说 明 一 下 ， 下 面 是 对 一 个 直流 信号 进行 FFT 变 换 : 


>>> X = np.ones(8) 

>>> X 

array([ 1. Ila ale ke eke D 

>>> np. fft. a 

array([ oj oto oOo, 0 10 T0000 OTO 
0.+0.j]) 


可 a 
所 谓 直 流 信号 ， 就 是 其 值 不 随时 间 变 化 ， 因 此 我 们 创建 一 个 值 全 为 1 的 数组 x， 我 们 
看 到 它 的 FFT 结 果 除了 下 标 为 0 的 数值 不 为 0 以 外 ， 其 余 的 都 为 0。( 为 了 计算 各 个 成 


分 的 能 量 多 少 ， 需 要 将 FFT 的 结果 除 以 FFT 的 长 度 )， 这 表示 我 们 的 时 域 信号 是 直流 
的 ， 并 且 其 成 分 为 1。 


下 面 我 们 产生 一 个 周期 为 8 个 取样 的 正弦 波 ， 然 后 观察 其 FFT 的 结果 : 





>>> x np.arange(0, 2*np.pi, 2*np.pi/8) 
>>> y np.sin(x) 
>>> np. fft.fft(y)/len(y) 
array([ 1.42979161e-18 +0.00000000e+00j, 
-4.44089210e-16 -5.00000000e-01j, 
1.53075794e-17 -1.38777878e-17]j, 
3.87737802e-17 -1.11022302e-16j, 
2.91853672e-17 +0.00000000e+00j, 
0.00000000e+00 -9.71445147e-17j, 
1.53075794e-17 +1.38777878e-17]j, 3.44085112e-16 +5.00000000e- 01° 





如 何 用 linspace 创 建 取 祥 点 x 


要 计算 周期 为 8 个 取样 的 正弦 波 ， 就 需要 把 0-2pi 的 区 间 等 分 为 8 分 ， 如 果 用 
np.linspace(0, 2np.pi, 8) 的 话 ， 产 生 的 值 为 : 


>>> np.linspace(0, 2*np.pi, 8) 

array([ O\. , ©.8975979 , 1.7951958 , 2.6927937 , 3.590: 
4.48798951, 5.38558741, 6.28318531] ) 

>>> 2*np.pi / 0.8975979 

7 .0000000079986666 


‘| — E: 








可 以 看 出 上 面 用 linspace 只 等 分 为 7 份 ， 如 果 要 正确 使 用 np.linspace 的 话 ， 可 以 如 
下 调用 ， 产 生 9 个 点 ， 并 且 设 置 endpoint=False， 最 终结 果 不 包括 最 后 的 那个 点 : 


>>> np.linspace(0, 2*np.pi, 9, endpoint=False) 
array([ 6N， , ©.6981317 , 1.3962634 , 2.0943951 , 2.792! 
3.4906585 , 4.1887902 , 4.88692191, 5.58505361]) 





让 我 们 再 来 看 看 对 正弦 波 的 FFT 的 计算 结果 吧 。 可 以 看 到 下 标 为 1 的 复数 的 虚数 部 分 
为 -0.5， 而 我 们 产生 的 正弦 波 的 放大 系数 (振幅 ) 为 1{， 它 们 之 间 的 关系 是 -0.5* (-2) 
=1。 再 来 看 一 下 余弦 波形 : 


>>> np.fft.fft(np.cos(x))/len(x) 
array([ -4.30631550e-17 +0.00000000e+00j, 

5.00000000e-01 -2.52659764e-16)j, 

1.53075794e-17 +0.00000000e+00j, 

1.11022302e-16 +1.97148613e-16j, 

1.24479962e-17 +0.00000000e+00j, 

-1.11022302e-16 +1.91429446e-16j, 

1.53075794e-17 +0.00000000e+00j, 5.00000000e-01 -1.35918295e-16° 


a] 


只 有 下 标 为 1 的 复数 的 实数 部 分 有 有 效 数 值 0.5， 和 余弦 波 的 放大 系数 1 之 间 的 关系 
是 0.5*2=1。 再 来 看 2 个 例子 : 





>>> np. fft.fft(2*np.sin(2*x) )/len(x) 
array([ 6.12303177e-17 +0.00000000e+00j, 

6.12303177e-17 +6.12303177e-17]j, 

-1.83690953e-16 -1.00000000e+00j, 

6.12303177e-17 -6.12303177e-17]j, 

6.12303177e-17 +0.00000000e+00j, 

6.12303177e-17 +6.12303177e-17]j, 

-1.83690953e-16 +1.00000000e+00j, 6.12303177e-17 -6.12303177e-1， 
>>> np.fft.fft(0.8*np.cos(2*x) )/len(x) 
array([ -2.44921271e-17 +0.00000000e+00j, 

-3.46370983e-17 +2.46519033e-32j, 

4.00000000e-01 -9.79685083e-17]j, 

3.46370983e-17 -3.08148791e-32j, 

2.44921271e-17 +0.00000000e+00j, 

3.46370983e-17 -2.46519033e-32j, 

4.00000000e-01 +9.79685083e-17j, -3.46370983e-17 +3.08148791e- 32: 


E ~ ë ëR 
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的 复数 中 ， 其 中 正弦 波 的 放大 系数 为 2, 因 此 频 域 虚数 部 分 的 值 为 -1 ; RIARIK 
系数 为 0.8， 因 此 其 对 应 的 值 为 0.4。 


同 频率 的 正弦 波 和 余弦 波 通过 不 同 的 系数 重 加 ， 可 以 产生 同 频 率 的 各 种 相位 的 余弦 
波 ， 因 此 我 们 可 以 这 样 来 理解 频 域 中 的 复数 : 


。 复数 的 模 (绝对 值 ) 代表 了 此 频率 的 余弦 波 的 振幅 
。 复数 的 辐 角 代表 了 此 频率 的 余弦 波 的 相位 


让 我 们 来 看 最 后 一 个 例子 : 





>>> X p.arange(0, 2*np.pi, 2*np.pi/128) 
>>> y .3*np.cos(x) + 0.5*np.cos(2*x+np.pi/4) + 0.8*np,cos(3*X-nf 
>>> yf = np.fft.fft(y)/len(y) 

>>> yf[:4] 

array([ 1.00830802e-17 +0.00000000e+00j, 

1.50000000e-01 +6.27820821e-18j, 

1.76776695e-01 +1.76776695e-01j, 2.00000000e-01 -3.46410162e-01° 
>>> np.angle(yf[1] ) 
4.1854721366992471e-017 
>>> np.abs(yf[1]), np.rad2deg(np.angle(yf[1])) 
(0.15000000000000008, 2.3980988870246962e-015) 
>>> np.abs(yf[2]), np.rad2deg(np.angle(yf[2])) 
(0.25000000000000011, 44.999999999999993) 
>>> np.abs(yf[3]), np.rad2deg(np.angle(yf[3]) ) 
(0.39999999999999991, -60.000000000000085 ) 


JE See) 
在 这 个 例子 中 我 们 产生 了 三 个 不 同 频 率 的 余弦 波 ， 并 且 给 他 们 不 同 的 振幅 和 相位 : 
e。 周期 为 128/1.0 点 的 余弦 波 的 相位 为 0， 振幅 为 0.3 


Os 





e。 周 期 为 64/2.0 点 的 余弦 波 的 相位 为 45 度 ， 振幅 为 0.5 
e 周期 为 128/3.0 点 的 余弦 波 的 相位 为 -60 度 ， 振 幅 为 0.8 


对 照 yf[1], yf[2], yf[3] 的 复数 振幅 和 辐 角 ， 我 想 你 应 该 对 FFT 结 果 中 的 每 个 数值 所 表 
示 的 意思 有 很 清楚 的 理解 了 吧 。 


合成 时 域 信号 


前 面 说 过 通过 if 函数 可 以 将 频 域 信号 转换 回 时 域 信 号 ， 这 种 转换 是 精确 的 。 下 面 我 
们 要 写 一 个 小 程序 ， 完 成 类 似 的 事情 ， 不 过 可 以 由 用 户 选 择 只 转换 一 部 分 频率 回 到 
时 域 信 号 ， 这 样 转换 的 结果 和 原始 的 时 域 信号 会 有 误差 ， 我 们 通过 观察 可 以 发 现 使 
用 的 频率 信息 越 多 ， 则 此 误差 越 小 ， 直 观 地 看 到 如 何 通过 多 个 余弦 波 逐步 逼近 任意 
的 曲线 信号 的 : 


# -*- coding: utf-8 -*- 

# 本 程序 演示 如 何 用 多 个 正弦 波 合成 三 角 波 
import numpy as np 

import pylab as pl 


# 取 FFT 计 算 的 结果 freqs 中 的 前 n 项 进行 合成 ， 返 回合 成 结果 ， 计 算 loops 个 周期 的 波形 
def fft_combine(freqs, n, loops= 1): 
length = len(freqs) * loops 
data = np.zeros(length) 
index = loops * np.arange(0, length, 1.0) / length * (2 * np.p: 
for k, p in enumerate(freqs[:n]): 
if k != 0: p *= 2 # 除去 直流 成 分 之 外 ， 其 余 的 系数 都 *2 
data += np.real(p) * np.cos(k*index) # 余弦 成 分 的 系数 为 实数 部 
data -= np.imag(p) * np.sin(k*index) # 正弦 成 分 的 系数 为 负 的 虚 妆 
return index, data 


# 产生 size 点 取样 的 三 角 波 ， 其 周期 为 1 
def triangle_wave(size): 
x np.arange(0, 1, 1.0/size) 
y = np.where(x<0.5, x, 0) 
y = np.where(x>=0.5, 1-x, y) 
return x, y 


fft_size = 256 


# 计算 三 角 波 和 其 FFT 
x, y = triangle_wave(fft_size) 
fy = = np.fft.fft(y) / fft_size 


# 绘制 三 角 波 的 FFT 的 前 20 项 的 振幅 ， 由 于 不 含 下 标 为 偶数 的 值 均 为 0 因此 取 

# 10g 之 后 无 穷 小 ， 无 法 绘图 ， 用 np ,clip 辑 数 设 置 数组 值 的 上 下 限 ， 保 证 绘图 正确 
pl.figure() 

pl.plot(np.clip(20*np.logi0(np.abs(fy[:20])), -120, 120), "o") 
pl.xlabel("frequency bin") 

pl.ylabel("power(dB)") 

pl.title("FFT result of triangle wave") 


绘制 原始 的 三 角 波 和 用 正弦 波 逐 级 合成 的 结果 ， 使 用 取样 点 为 X 轴 坐标 

pl.figure() 

pl.plot(y, label="original triangle", linewidth=2) 

for Al an lo i, 3,577, 91% 
index, data = fft_combine(fy, i+1, 2) # 计算 两 个 周期 的 合成 波形 
pl.plot(data, label = "N=%s" % i) 

pl.legend() 

pl.title("partial Fourier series of triangle wave") 

pl.show( ) 
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部 分 频谱 重建 的 三 角 波 


第 18 行 的 triangle_wave 男 数 产 生 一 个 周期 的 三 角 波 形 ， 注 意 我 们 使 用 np.where 函 数 
计算 区 间 男 数 的 值 。triangle 函 数 返 回 两 个 数组 ， 分 别 表 示 x 轴 和 y 轴 的 值 。 注 意 后 面 
的 计算 和 绘图 不 使 用 x 轴 坐标 ， 而 是 直接 用 取样 次 数 作 为 X 轴 坐标 。 


第 7 行 的 件 _combine 的 函数 使 用 人 的 结果 freqs 中 的 前 n 个 数据 重新 合成 时 域 信 号 ， 由 
合成 所 使 用 的 信号 都 是 正弦 波 这 样 的 周期 信号 ， 所 以 我 们 可 以 通过 第 三 个 参数 
loops 指 定 计 算 几 个 周期 。 


通过 这 个 例子 ， 我 们 可 以 看 出 使 用 的 频率 越 多 ， 最 终 合成 的 波形 越 接近 原始 的 三 角 


3, o 


合成 方 波 


由 于 方 波 的 波形 中 存在 跳 变 ， 因 此 用 有 限 个 正弦 波 合成 的 方 波 在 跳 变 出 现 抖动 现 
象 ， 如 下 图 所 示 ， 用 正弦 波 合成 的 方 波 的 收敛 速度 比 三 角 波 慢 得 多 : 


计算 方 波 的 波形 可 以 采用 如 下 的 函数 : 
def square_wave(size): 
x = np.arange(0, 1, 1.0/size) 


y = np.where(x<0.5, 1.0, 0) 
return x, y 


partial Fourier series of square wave 
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三 角 波 FFT 演 示 程 序 


我 们 希望 制作 一 个 用 户 友好 的 界面 ， 交 互 式 地 观察 各 种 三 角 波 的 频谱 以 及 其 正弦 合 
成 的 近似 波形 。 制作 界面 是 一 件 很 费 工 的 事情 ， 幸 好 我 们 有 TraitsUl 库 的 帮忙 ， 不 
到 200 行 程序 就 可 以 制作 出 如 下 的 效果 了 : 


程序 中 已 经 给 出 了 详细 的 注释 ， 相 信 大 家 能 够 读 懂 并 掌握 这 类 程序 的 写法 ， 其 中 需 
要 注意 的 几 点 


e 16 行 ， 用 ScrubberEditor 创 建 一 个 自 定义 样式 的 拖 动 调整 值 的 控件 ，77-80 行 设 
置 ltem 的 editor = scrubber， 这 样 就 用 我 们 自 定义 的 控件 修改 trait 属 性 了 ， 如 果 
不 指定 editor 的 话 ，Range 类 型 的 trait 属 性 将 以 一 个 滚动 条 做 为 编辑 器 。 


用 Range traits 可 以 指定 一 个 带 范围 的 属性 ， 它 可 以 设置 上 限 下 限 ， 上 上 下限 可 以 
用 整数 或 者 浮 点 数 直 接 指定 ， 也 可 以 用 另外 一 个 trait 属 性 指定 (用 字符 串 指 定 
trait 属 性 名 )， 但 是 几 种 类 型 不 能 混用 ， 因 此 程序 中 专门 设计 了 两 个 常数 的 trait 
属性 (36, 37 行 )， 它 们 的 作用 只 是 用 来 指定 其 它 trait 属 性 的 上 下 限 。 


low = Float(0.02) 
hi = Float(1.0) 


19077 Mtriangle_funcH 2438] —“# F frompyfunc 4) by ufuncH aX, 150478 
Ib i+ B= AR, (22 Afrompyfuncé) 24 ufunck Bik RR BTCA 
F(dtype)#object, Abs Acast["float64"| asa bl H tie REY 
float64 的 数组 。 


o 处 理 trait 属 性 的 改变 事件 最 简单 的 方式 就 是 用 固定 的 函数 名 : trait 属 性 名 
_changed， 但 是 当 多 个 trait 属 性 需要 共用 某 一 个 义理 函数 时 ， 用 
@on trait _ change 更 加 简洁 。 


下 面 是 完整 的 程序 : 


# -*- coding: utf-8 -*- 
from enthought.traits.api import \ 


Str, Float, HasTraits, Property, cached_property, Range, Instar 


from enthought.chaco.api import Plot, AbstractPlotData, ArrayPlotDé 


from enthought.traits.ui.api import \ 


Item, View, VGroup, HSplit, ScrubberEditor, VSplit 


from enthought.enable.api import Component, ComponentEditor 
from enthought.chaco.tools.api import PanTool, ZoomTool 


import numpy as np 


# 鼠标 抑 动 修改 值 的 控件 的 祥 式 
scrubber = ScrubberEditor ( 


) 


hover_color = OXxFFFFFF, 
active_color OxAOCD9E, 
border_color 0x808080 


# 取 FFT 计 算 的 结果 freqs 中 的 前 n 项 进行 合成 ， 返 回合 成 结果 ， 计 算 1oops 个 周期 的 波形 
def fft_combine(freqs, n, loops=1): 


length = len(freqs) * loops 
data = np.zeros(length) 
index = loops * np.arange(0, length, 1.0) / length * (2 * np.p: 
for k, p in enumerate(freqs[:n]): 
if k != 0: p *= 2 # 除去 直流 成 分 之 外 ， 其 余 的 系数 都 *2 
data += np.real(p) * np.cos(k*index) # 余弦 成 分 的 系数 为 实数 部 
data -= np.imag(p) * np.sin(k*index) # 正弦 成 分 的 系数 为 负 的 虚 妆 
return index, data 


class TriangleWave(HasTraits): 


# 指定 三 角 波 的 最 窗 和 最 宽 范 围 ， 由 于 Range 似 乎 不 能 将 常数 和 traits 名 混用 
# 所 以 定义 这 两 个 不 变 的 trait 属 性 

low = Float(0.02) 

hi = Float(1.0) 


# 三 角 波 形 的 宽度 
wave_width = Range("low", "hi", 0.5) 


# 三 角 波 的 顶点 C 的 X 轴 坐标 
length_c = Range("low", "wave_width", 0.5) 


# 三 角 波 的 定点 的 y 轴 坐标 
height_c = Float(1.0) 


# FFT 计 算 所 使 用 的 取样 点 数 ， 这 里 用 一 个 Enum 类 型 的 属性 以 供用 户 从 列表 中 选择 
fftsize = Enum( [(2**x) for x in range(6, 12)]) 


# FFT 频 谱 图 的 X 轴 上 限 值 
fft_graph_up_ limit = Range(0, 400, 20) 


# 用 于 显示 FFT 的 结 
peak_list = Str 


# 
N 


ll 4 


呆 用 多 少 个 频率 合成 三 角 波 
Range(1, 40, 4) 


# 保存 绘图 数据 的 对 象 
plot_data = Instance(AbstractPlotData) 


绘制 波形 图 的 容器 
plot_wave = Instance(Component ) 


绘制 FFT 频 谱 图 的 容器 
plot_fft = Instance(Component) 


# 包括 两 个 绘图 的 容器 


container = Instance(Component) 


# 设置 用 户 界面 的 视图 ， 注意 一 定 要 指定 窗口 的 大 小 ， 这 样 绘图 容器 才能 正常 初始 人 
view = View( 
HSplit( 
VSplit ( 
VGroup( 

Item("wave_width", editor = scrubber, label=u 
Item("length_c", editor = scrubber, label=u" 
Item("height_c", editor = scrubber, label=u" 
Item("fft_graph_up_limit", editor = scrubber, 
Item("fftsize", label=u"FFTRR"), 
Item("N"，1label=u" 合 成 波 频 率 数 ") 


5 
BR ir 
=i 
EXIF 


) ， 


Item("peak_list", style="custom", show_label=False, 


) ， 


VGroup ( 
Item("container", editor=ComponentEditor(size=(600, 
orientation = "vertical" 

) 


), 

resizable = True, 

width = 800, 

height = 600, 

title = u" 三 角 波 FFT 演 示 " 
) 


H 创建 绘图 的 辅助 画 数 ， 创 建 波形 图 和 频谱 图 有 很 多 类 似 的 地 方 ， 因 此 单独 用 一 
# 减少 重复 代码 
_create_plot(self, data, name, type="line"): 
p = Plot(self.plot_data) 
p.plot(data, name=name, title=name, type=type) 
p.tools.append(PanTool(p) ) 
zoom = ZoomTool(component=p, tool_mode="box", always_on=Fa- 
p.overlays.append(zoom) 
p.title = name 


return p 


def _ init__(self): 
# 首先 需要 调用 父 类 的 初始 化 函数 
super(Trianglewave, self). _init_ () 


# 创建 绘图 数据 集 ， 暂 时 没有 数据 因此 都 赋值 为 空 ， 只 是 创建 几 个 名 字 ， 以 供 P- 
self.plot_data = ArrayPlotData(x=[], y=[], f=[], p=[], x2=| 


# 创建 一 个 垂直 排列 的 绘图 容器 ， 它 将 频谱 图 和 波形 图 上 下 排列 
self.container = VPlotContainer() 


# 创建 波形 图 ， 波 形 图 绘制 两 条 曲线 : 原始 波形 (x, y ) 和 合成 波形 (x2, y2) 
self.plot_wave = self. create plot(("x","y"), "Triangle Wan' 
self.plot wave.plot(("x2","y2"), color="red") 


# 创建 频谱 图 ， 使 用 数据 集中 的 f 和 p 
self.plot_fft = self. create plot(("f","p"), "FFT", type=' 


# 将 两 个 绘图 容器 添加 到 垂直 容器 中 
self.container.add( self.plot_wave ) 
self.container.add( self.plot_fft ) 


# 设置 

self.plot_wave.x_axis.title = "Samples" 
self.plot_fft.x_axis.title = "Frequency pins" 
self.plot_fft.y_axis.title = "(dB)" 
# 改变 fftsize 为 1024， 因 为 Enum 的 默认 缺 省 值 为 枚 举 列表 中 的 第 一 个 值 
self.fftsize = 1024 


# FFT Init A Axi EIRA AIA SBA RIAN, Sma aay it A AS a A R lE 
def _fft_graph_up_limit_changed(self): 
self.plot_fft.x_axis.mapper.range.high = self.fft_graph_up_ 


def _N _changed(self): 
self .plot_sin_combine() 


# 多 个 trait 属 性 的 改变 事件 义理 函数 相同 时 ， 可 以 用 @on_trait_change 指 定 
@on_trait_change("wave_width, length_c, height_c, fftsize") 
def update _plot(self): 

# 计算 三 角 波 

global y_data 

x_data = np.arange(0, 1.0, 1.0/self.fftsize) 

func = self.triangle_func() 

# 将 func 汞 数 的 返回 值 强制 转换 成 float64 

y_data = np.cast["float64"](func(x_data) ) 


# 计算 频谱 
fft_parameters = np.fft.fft(y data) / len(y_data) 


# 计算 各 个 频率 的 振幅 
fft_data = np.clip(20*np.1logi0(np.abs(fft_parameters) )[:se- 


# 将 计算 的 结果 写 进 数据 集 

self.plot_data.set_data("x", np.arange(0, self.fftsize)) # 
self.plot_data.set_data("y", y_data) 
self.plot_data.set_data("f", np.arange(0, len(fft_data))) #; 
self.plot_data.set_data("p", fft_data) 


# 合成 波 的 x 坐 标 为 取样 点 ， 显 示 2 个 周期 
self.plot_data.set_data("x2", np.arange(0, 2*self.fftsize) | 


# 更 新 频谱 图 X 轴 上 限 
self._fft_graph_up_limit_changed( ) 


# 将 振幅 大 于 -80dB 的 频率 输出 

peak_index = (fft_data > -80) 

peak_value = fft_data[peak_index][:20] 

result = [] 

for f, v in zip(np.flatnonzero(peak_index), peak_value): 
result.append("%s : %s" %(f, v) ) 

self.peak_list = "\n".join(result) 


# 保存 现在 的 fft 计 算 结果 ， 并 计算 正弦 合成 波 
self.fft_parameters = fft_parameters 
self .plot_sin_combine( ) 


# 计算 正弦 合成 波 ， 计 算 2 个 周期 

def plot_sin_combine(self): 
index, data = fft_combine(self.fft_parameters, self.N, 2) 
self.plot_data.set_data("y2", data) 


# 返回 一 个 ufunc 计 算 指 定 参 数 的 三 角 波 
def triangle_func(self): 

c = self.wave_width 

co self.length_c 

he self .height_c 


def trifunc(x): 


x = x - int(x) # 三 角 波 的 周期 为 1， 因 此 只 取 Xx 坐 标的 小 数 部 分 进行 ; 
if x>=c:r=0.0 

elif x < c0: r =x / c0 * he 

else: r = (c-x) / (c-c0) * he 


return r 


# Htrifunnc KHa — ufun KA, TAEA AT, Fed! 
# 计算 得 到 的 是 一 个 0bject 数 组 ， 需 要 进行 类 型 转换 
return np.frompyfunc(trifunc, 1, 1) 
if _ name == "_ main_": 
triangle = TriangleWave( ) 
triangle.configure_traits() 








频 域 信号 处 理 


用 FFT( 快 速 传 立 叶 变 换 ) 能 将 时 域 的 数字 信号 转换 为 频 域 信号 。 转 换 为 频 域 信号 之 

FN Ro a e UD as AIM, HILT RE, RAATI 
完毕 的 频 域 信号 通过 IFFT( 逆 变换 ) 转 换 为 时 域 信 号 ， 实 现 许 多 在 时 域 无 法 完成 的 

信 号 处 理 算法 。 本 章 通过 几 个 实例 ， 简 单 地 介绍 有 关 频 域 信号 处 理 的 一 些 基本 知 


Fo 


观察 信 号 的 频谱 


将 时 域 信号 通过 FFT 转 换 为 频 域 信 号 之 后 ， 将 其 各 个 频率 分 量 的 幅 值 绘制 成 图 ， 可 
以 很 直观 地 观察 信号 的 频谱 。 下 面 的 程序 完成 这 一 任务 : 


# -*- coding: utf-8 -*- 
import numpy as np 
import pylab as pl 


sampling_rate = 8000 
o _size = 512 
= np.arange(0, 1.0, 1.0/sampling_rate) 
x = np.sin(2*np.pi*156.25*t) + 2*np.sin(2*np.pi*234.375*t) 
xs = x[:fft_size] 
xf = np.fft.rfft(xs)/fft_size 
freqs = np.linspace(0, sampling_rate/2, fft_size/2+1) 
xfp = 20*np.logi0(np.clip(np.abs(xf), 1e-20, 1¢100) ) 
pl.figure(figsize=(8,4)) 
pl.subplot(211) 
pl.plot(t[:fft_size], xs) 
pl.xlabel(u"#t iq (#)") 
pl.title(u"156.25Hz 和 234.375Hz 的 波形 和 频谱 ") 
pl. subplot(212) 
pl.plot(freqs, xfp) 
pl.xlabel(u" 频 率 (Hz)") 
pl.subplots_adjust(hspace=0.4) 
pl.show( ) 


下 面 逐 行 对 这 个 程序 进行 解释 : 


首先 定义 了 两 个 常数 : sampling_rate, fft_size， 分 别 表示 数 字 信 号 的 取样 频率 和 
FFT 的 长 度 。 


然后 调用 np.arange 产 生 1 秒 钟 的 取样 时 间 ，t 中 的 每 个 数值 直接 表示 取样 点 的 时 间 ， 
因此 其 间隔 为 取样 周期 1/sampline_rate : 


t = np.arange(0, 1.0, 1.0/sampling_rate) 


FARE AY a Bt LRA AWA RS, BEANE TIER 
的 和 加 ， 一 个 频率 是 156.25Hz， 一 个 是 234.375Hz : 


x = np.sin(2*np.pi*156.25*t) + 2*np.sin(2*np.pi*234.375*t) 


为 什么 选择 这 两 个 奇怪 的 频率 呢 ? 因为 这 两 个 频率 的 正弦 波 在 512 个 取样 点 中 正好 
有 整数 个 周期 。 满 足 这 个 条 件 波形 的 FFT 结 果 能 够 精确 地 反映 其 频谱 。 


N 点 FFT 能 精确 计算 的 频率 


假设 取样 频率 为 fs, 取 波 形 中 的 N 个 数据 进行 FFT 变 换 。 那 么 这 NN 点 数据 包含 整数 个 
周期 的 波形 时 ，FFT 所 计算 的 结果 是 精确 的 。 于 是 能 精确 计算 的 波形 的 周期 是 : 
n*fs/N。 对 于 8kHz 取 样 ，512 点 FFT 来 说 ，8000/512.0 = 15.625Hz， 前 面 的 
156.25Hz 和 234.375Hz 正 好 是 其 10 倍 和 15 倍 。 


下 面 从 波形 数据 x 中 截取 估 _size 个 点 进行 估计 算 。np. 伯 库 中 提供 了 一 个 rfft 芳 数 ， 
方便 我 们 对 实数 信号 进行 FFT 计 算 。 根 据 FFT 计 算 公 式 ， 为 了 A 
RS rit ey 2s RIR ATft_ size : 


xs 
xf 


x[:fft_size] 
np.fft.rfft(xs)/fft_size 


rfft 范 数 的 返回 值 是 N/2+1 个 复数 ， 分 别 表 示 从 0(Hz) 到 sampling_rate/2(Hz) 的 N/2+1 
点 频率 的 成 分 。 于 是 可 以 通过 下 面 的 np.linspace 计 算出 返回 值 中 每 个 下 标 对 应 的 真 
正 的 频率 : 


freqs = np.linspace(0, sampling_rate/2, fft_size/2+1) 


后 我 们 计算 每 个 频率 分 量 的 幅 值 ， 并 通过 20*np.log10() 将 其 转换 为 以 db 单位 的 
ft. 为 了 防止 0 幅 值 的 成 分 造成 lo0g10 无 法 计算 ， 我们 调用 np.clip 对 xf 的 幅 值 进行 上 
下 限 处 理 : 


xfp = 20*np.logi0(np.clip(np.abs(xf), 1e-20, 1e100)) 


剩 下 的 程序 就 是 将 时 域 波 形 和 频 域 波形 绘制 出 来 ， 这 里 就 不 再 详细 叙述 了 。 此 程序 
的 输出 为 : 


156.25Hz 和 234.375Hz 的 波形 和 频谱 


全 6 8.61 0.02 0.03 0.04 0.05 0.06 0.07 
时 间 ( 秒 ) 


500 1000 1508 2000 2500 3000 3500 4900 
频率 (Hz) 


使 用 FFT 计 算 正 弦 波 的 频谱 
如 果 你 放大 其 频谱 中 的 两 个 峰值 的 部 分 的 话 ， 可 以 看 到 其 值 分 别 为 : 


>>> xfp[10] 

-6. 0205999132796251 

>>> xfp[15] 
-9.6432746655328 714e-16 


即 156.25Hz 的 成 分 为 -6dB， 而 234.375Hz 的 成 分 为 0dB， 与 波形 的 计算 公式 中 的 各 
个 分 量 的 能 量 (振幅 值 /2) 符 合 。 


如 果 我 们 波形 不 能 在 伯 _size 个 取样 中 形成 整数 个 周期 的 话 会 怎样 呢 ? 
将 波形 计算 公式 修改 为 : 


x = np.sin(2*np.pi*200*t) + 2*np.sin(2*np.pi*300*t) 


得 到 的 结果 如 下 : 


266Hz 和 366Hz 的 波形 和 频谱 


3 
2 
1 


6.00 0.01 0.02 0.03 0.04 0.05 0.06 0.07 
时 间 ( 秒 ) 
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非 完整 周期 的 正弦 波 经 过 FFT 变 换 之 后 出 现 频谱 泄漏 


这 次 得 到 的 频谱 不 再 是 两 个 完美 的 峰值 ， 而 是 两 个 峰值 频率 周围 的 频率 都 有 能 量 。 
这 显然 和 两 个 正弦 波 的 县 加 波形 的 频谱 有 区 别 。 本 来 应 该 属于 200Hz 和 300Hz 的 能 
量 分 散 到 了 周转 的 频率 中 ， 这 个 现象 被 称 为 频谱 泄漏 。 出 现 频 谱 泄 漏 的 原因 在 于 
fft_size 个 取样 点 无 法 放下 整数 个 200Hz 和 300Hz 的 波形 。 


频谱 泄漏 的 解释 


我 们 只 能 在 有 限 的 时 间 段 中 对 信号 进行 测量 ， 无 法 知道 在 测量 范围 之 外 的 信号 是 怎 
样 的 。 因 此 只 能 对 测量 范围 之 外 的 信号 进行 假设 。 而 傅立叶 变换 的 假设 很 简单 : 测 
量 范 围 之 外 的 信号 是 所 测量 到 的 信号 的 重复 。 


现在 考虑 512 点 FFT， 从 信号 中 取出 的 512 个 数据 就 是 FFT 的 测量 范围 ， 它 计算 的 是 
这 512 个 数据 一 直 重复 的 波形 的 频谱 。 显 然 如 果 512 个 数据 包含 整数 个 周期 的 话 ， 那 
么 得 到 的 结果 就 是 原始 信号 的 频谱 ， 而 如 果 不 是 整数 周期 的 话 ， 得 到 的 频谱 就 是 如 
下 波形 的 频 详 ， 这 里 假设 对 50Hz 的 正弦 波 进行 512 点 FFT : 


>>> t np.arange(0, 1.0, 1.0/8000) 
>>> X np.sin(2*np.pi*50*t)[:512] 
>>> pl.plot(np.hstack([x,x,x])) 

>>> pl.show() 


56Hz 正 弦 波 的 512 点 FFT 所 计算 的 频谱 的 实际 波形 


INN 


50Hz 正 弦 波 的 512 点 FFT 所 计算 的 频谱 的 实际 波形 


由 于 这 个 波形 的 前 后 不 是 连续 的 ， 出 现 波形 跳 变 ， 而 跳 变 多 的 有 着 非常 广泛 的 频 
谱 ， 因 此 FFT 的 结果 中 出 现 频 谱 泄 漏 。 


1200 


Ea aX 
oe ee 的 跳 变 ， 可 以 对 数据 先 乘 以 一 个 窗 函 数 ， 使 得 其 
前 后 数据 能 平滑 过 渡 。 例 如 常用 的 hann 窗 函数 的 定义 如 下 : 





i 277n 
win) = 0.5 — cos Vo 


其 中 N 为 窗 范 数 的 点 数 ， 下 面 是 一 个 512 点 hann 窗 的 曲线 : 


>>> import pylab as pl 

>>> import scipy.signal as signal 
>>> pl. figure(figsize=(8,3)) 

>>> pl.plot(signal.hann(512) ) 


hann window 


9 166 200 300 490 500 


hann 窗 函数 


窗 函 数 都 在 scipy.signal 库 中 定义 ， 它 们 的 第 一 个 参数 为 点 数 N。 可 以 看 出 hann 窗 函 
数 是 完全 对 称 的 ， 也 就 是 说 第 0 点 和 第 511 点 的 值 完全 相同 ， 都 为 0。 在 这 样 的 函数 
和 信号 数据 相 乘 的 话 ， 结 果 中 会 出 现 前 后 两 个 连续 的 0， 这 样 FFT 的 结果 所 表示 的 周 
期 信号 中 有 两 个 连续 的 0 值 ， 会 对 信号 的 周期 性 有 一 定 的 影响 。 


计算 周期 信号 的 一 个 周期 的 数据 


考虑 对 一 个 正弦 波 取样 10 个 点 ， 那 么 第 一 个 点 的 值 为 0， 而 最 后 一 个 点 的 值 不 应 该 
sa 这 样 这 10 个 数据 的 重复 才能 是 精确 的 正弦 波 ， 下 面 的 两 种 计算 中 ， 前 者 是 正 
确 的 : 


>>> np.sin(np.arange(@, 2*np.pi, 2*np.pi/10) ) 

array([ 0©.00000000e+00, 5.87785252e-01, 9.51056516e-01, 
9.51056516e-01, 5.87785252e-01, 1.22464680e-16, 
-5.87785252e-01, -9.51056516e-01, -9.51056516e-01, 
-5.87785252e-01] ) 

>>> np.sin(np.linspace(0, 2*np.pi, 10)) 

array([ 0©.00000000e+00, 6.42787610e-01, 9.84807753e-01, 
8.66025404e-01, 3.42020143e-01, -3.42020143e-01, 
-8.66025404e-01, -9.84807753e-01, -6.42787610e-01, 
-2.44929360e-16]) 


为 了 解决 连续 0 值 的 问题 ，hann 函 数 提供 了 一 个 sym 关 键 字 人 参数， 如果 设 置 其 为 0 的 
话 ， 那 么 将 产生 一 个 N+1 点 的 hann 窗 函数 ， 然 后 取 其 前 N 个 数 ， 这 样 得 到 的 窗 函 数 
适合 于 周期 信号 : 


>>> signal.hann(8) 


array([ O\. , ©.1882551 , 0.61126047, 0.95048443, 0.950 
0.61126047, ©.1882551 , O\. ]) 

>>> signal.hann(8, sym=0) 

array([ O\. , ©.14644661, 0.5 - 085355339  2N: 
0.85355339, 0.5 , 0.14644661]) 





50HZE R AS Bi WBE NER RANT : 


>>> t np.arange(0, 1.0, 1.0/8000) 

>>> X np.sin(2*np.pi*50*t)[:512] * signal.hann(512, sym=0) 
>>> pl.plot(np.hstack([x,x,x])) 

>>> pl.show() 


58Hz 正 弦 波 (加 hann 窗 ) 的 512 点 FFT 所 计算 的 频谱 的 实际 波形 


200 400 600 800 1000 1200 1400 1600 


加 hann 窗 的 50Hz 正 弦 波 的 512 点 FFT 所 计算 的 实际 波形 


回 到 前 面 的 例子 ， 将 200Hz, 300Hz 的 得 加 波形 与 hann 窗 乘积 之 后 再 计算 其 频谱 ， 
得 到 如 下 频谱 图 : 


266Hz 和 366Hz 的 波形 和 频谱 





ð 500 1900 1500 2000 2500 3000 3500 4900 


频率 (Hz) 
加 hann 窗 前 后 的 频谱 ，hann 窗 能 降低 频谱 泄漏 
可 以 看 到 与 hann 窗 乘积 之 后 的 信号 的 频谱 能 量 更 加 集中 于 200Hz 和 300Hz， 但 是 其 
能 量 有 所 降低 。 这 是 因为 hann 窗 本 身 有 一 定 的 能 量 衰减 : 


>>> np.sum(signal.hann(512, sym=0))/512 
0.5 


因此 如 果 需 要 严格 保持 信号 的 能 量 的话 ， 还 需要 在 乘 以 hann 窗 之 后 再 乘 以 2。 
上 面 完整 绘图 程序 请 参照 : 频谱 泄漏 和 hann 窗 


频谱 平均 


对 于 频谱 特性 不 随时 间 变 化 的 信号 ， 例 如 引擎 、 压 缩 机 等 机 器 噪声 ， 可 以 对 其 进行 
长 时 间 的 采样 然后 分 段 进行 FFT 计 算 ， 最 后 对 每 个 频率 分 量 的 幅 值 求 其 平均 值 可 
以 准确 地 测 | 量 信 号 的 频谱 M Tz o 


下 面 的 程序 完成 这 一 计算 : 


import numpy as np 
import scipy.signal as signal 
import pylab as pl 


def average _fft(x, fft_size): 
= len(x) // fft_size * fft_size 
tmp = x[:n].reshape(-1, fft_size) 
tmp *= signal.hann(fft_size, sym=0) 
xf = np.abs(np.fft.rfft(tmp)/fft_size) 
avgf = np.average(xf, axis=0) 
return 20*np.1lo0g10(avgf ) 


average_fft(x, 代 _size) 对 数组 x 进 行 代 _ size 点 FFT 运 算 ， 以 dB 为 单位 返回 其 平均 后 
的 幅 值 。 由 于 x 的 长 度 可 能 不 是 ft_size 的 整数 倍 ， 因 此 首先 将 其 缩短 为 傣 _size 的 整 
数 倍 ， 然 后 用 reshape 画 数 将 其 转换 为 一 个 二 维 数 组 tmp。tmp 的 第 1 轴 的 长 度 为 
fft_size : 


len(x) // fft_size * fft_size 


n= 
tmp x[:in].reshape(-1, fft_size) 


a tmp ay ss 14a FASC GEA AFR, ix Bit AB Ehan : 


tmp *= signal.hann(fft_size, sym=0) 


调用 rfft 对 tmp 每 的 行 数据 进行 FFT 计 算 ， 并 求 其 幅 值 : 


xf = np.abs(np.fft.rfft(tmp)/fft_size) 


#2 Fk average žr AA BOs TAY, a AREARE 
幅 值 : 


avgf = np.average(xf, axis=0) 


Fle! Aaveragge_fftt 23+ FAN LA I ot BI 


>>> X = np.random.rand(100000) - 0.5 
>>> xf = average_fft(x, 512) 
>>> pl.plot(xf) 
>>> pl.show() 
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频率 窗口 (Frequency Bin) 


白色 噪声 的 频谱 接近 水 平 直线 (注意 Y 轴 的 范围 ) 


我 们 可 以 看 到 随机 噪声 的 频谱 接近 一 条 水 平 的 直线 ， 也 就 是 说 每 个 频率 窗口 的 能 量 
都 相同 ， 这 种 噪声 我 们 称 之 为 白色 噪声 。 

如 果 我 们 利用 scipy.signal 库 中 的 滤波 器 设计 画 数 ， 设 计 一 个 IIR 低 通 滤波 器 ， 将 白色 
噪声 输入 到 此 低 通 滤波 器 ， 绘 制 其 输出 数据 的 平均 频谱 的 话 ， 就 能 够 观察 到 1IR 滤 波 
器 的 频率 响应 特性 ， 下 面 的 程序 利用 iirdesign 设 计 一 个 8kHz 取 桩 的 1kHz 的 
Chebyshev | 型 低 通 滤波 器 ，iirdesign 画 数 需 要 用 正规 化 的 频率 ( 取 值 范围 为 0-1)， 
然后 调用 filtfilt 对 白色 噪声 信号 x 进 行 低 通 滤波 : 


>>> b,a=Signal.iirdesign(1000/4000.0, 1100/4000.0, 1, -40, ©, "chet 
>>> X = np.random.rand(100000) - 0.5 
>>> y = Ssignal.filtfilt(b, a, x) 


E N: 


如 果 用 average 估计 算 输 出 信号 y 的 平均 频谱 ， 得 到 如 下 频谱 图 : 





经 过 低 通 滤波 的 日 色 噪 声 的 频谱 
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频率 (Hz) 
经 过 低 通 滤波 器 的 白色 噪声 的 频谱 


快速 耸 积 


我 们 知道 ， 信 号 x 经 过 系统 h 之 后 的 输出 y 是 x 和 h 的 疮 积 ， 虽 然 耸 积 的 计算 方法 很 简 
单 ， 但 是 当 x 和 h 都 很 长 的 时 候 ， 郑 积 计 算是 非常 耗 病 时 间 的 。 因 此 对 于 比较 长 的 系 
统 h， 需 要 找到 比 直 接 计 算 耸 积 更 快 的 方法 。 


信号 系统 理论 中 有 这 样 一 个 规律 : 时 域 的 耸 积 等 于 频 域 的 乘积 ， 因 此 要 计算 时 域 的 
谷 积 ， 可 以 将 时 域 信 号 转换 为 频 域 信号 ， 进 行 乘 积 运算 之 后 再 将 结果 转换 为 时 域 信 
号 ， 实 现 快速 耸 积 。 


由 于 FFT 运 算 可 以 高 效 地 将 时 域 信 号 转换 为 频 域 信号 ， 其 运算 的 复杂 度 为 


O(N/og(N))， 因 此 三 次 FFT 运 算 加 一 次 乘积 运算 的 总 复杂 度 仍 然 为 O(Nlog(N)) 级 
别 ， 而 郑 积 运算 的 复 条 度 为 O(N*N)， 显 然 通 过 FFT 计 算 疮 积 要 比 直 接 计算 快速 得 


多 。 这 里 假设 需要 众 积 的 两 个 信号 的 长 度 都 为 N。 


但 是 有 一 个 问题 : FFT 运 算 假设 其 所 计算 的 信号 为 周期 信号 ， 因 此 通过 上 述 方法 计 
算出 的 结果 实际 上 是 两 个 信号 的 循环 和 众 积 ， 而 不 是 线性 众 积 。 为 了 用 FFT 计 算 线 性 
耸 积 ， 需 要 对 信号 进行 补 雳 扩展， 使 得 其 长 度 长 于 线性 疮 积 结果 的 长 度 。 


例如 ， 如 果 我 们 要 计算 数组 a 和 b 的 肉 积 ，a 和 b 的 长 度 都 为 128， 和 那么 它们 的 肉 积 结 
果 的 长 度 为 len(a) + len(b) - 1= 257。 为 了 用 FFT 能 够 计算 其 ieee, BEA 
b 都 扩展 到 256。 下 面 的 程序 演示 这 个 计算 过 程 : 


# -*- coding: utf-8 -*- 
import numpy as np 


def fft_convolve(a,b): 


n = len(a)+len(b)-1 
N = 2**(int(np.log2(n) )+1) 
A = np.fft.fft(a, N) 
B = np.fft.fft(b, N) 


return np.fft.ifft(A*B)[:n] 


if name_ == "_ main_": 
np. random. rand(128) 
np.random. rand(128) 
np.convolve(a,b) 


oa | 
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print np.sum(np.abs(c - fft_convolve(a,b))) 


此 程序 的 输出 为 直接 谷 积 和 FFT 快 速 巷 积 的 结果 之 间 的 误差 ， 大 约 为 5e-12 左 右 。 


在 这 段 程序 中 ，a,b 的 长 度 为 128， 其 内 积 结果 c 的 长 度 为 n=255， 我 们 通过 下 面 的 算 
式 找 到 大 于 n 的 最 小 的 2 的 整数 次 款 : 


N = 2**(int(np.log2(n) )+1) 


在 调用 伯 函 数 对 其 进行 变换 时 ， 传 递 第 二 个 参数 为 N(FFT 的 长 度 )， 这 样 俐 函数 闻 自 
动 对 a,b 进 行 补 堪 。 最 后 通过 ifft 得 到 的 谷 积 结果 c2 的 长 度 为 N， 上 比 实际 的 敬 积 结果 c 
要 多 出 一 个 数 ， 这 个 多 出 来 的 元 素 应 该 接近 于 0， 请 读者 自行 验证 。 


下 面 测试 一 下 速度 : 


>>> import timeit 

>>> setup="""import numpy as np 

a=np.random.rand(10000) 

b=np. random. rand(10000) 

from spectrum_fft_convolve import fft_convolve""" 

>>> timeit.timeit("np.convolve(a,b)",setup, number=10) 
1.852900578146091 

>>> timeit.timeit("fft_convolve(a,b)",setup, number=10) 
0.19475575806416145 
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短 的 数组 ， 直 接 卷 积 运算 将 更 快 一 些 。 下 图 显示 了 直接 卷 积 和 快速 耸 积 的 每 点 的 平 
均 计 算 时 间 和 长 度 之 间 的 关系 : 


卷 积 的 计算 时 间 
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用 FFT 计 算 卷 积 和 直接 疮 积 的 时 间 复杂 度 比 较 

由 于 图 中 的 Y 轴 表示 每 点 的 计算 时 间 ， 因 此 对 于 直接 疮 积 它 是 线性 的 : O(N*N)/N。 
我 们 看 到 对 于 1024 点 以 上 的 计算 ， 快 速 耸 积 显示 出 明显 的 优势 。 
具体 的 程序 请 参照 FF7 和 凑 积 的 速度 比较 


由 于 FFT 丛 积 很 常用 ， 因 此 scipy.signal 库 中 提供 了 fftconvolve 画 数 ， 此 函数 采用 
FFT 运 算 可 以 计算 多 维 数组 的 营 积 。 读 者 也 可 以 参照 此 函数 的 源 代码 帮助 理解 。 


分 段 运 算 


现在 考虑 对 于 输入 信号 x 和 系统 响应 h 的 疮 积 运算 ， 通 常 x 是 非常 长 的 ， 例 如 要 对 某 
段 录 音 进 行 滤波 处 理 ， 假 设 取样 频率 为 8KHz， 录 音 长 度 为 1 分 钟 的 话 ， 那 么 x 的 长 度 
为 480000。 而 且 x 的 长 度 也 可 能 不 是 固定 的 ， 例 如 我 们 可 能 需要 对 麦克 风 的 连续 输 
入 信号 进行 滤波 处 理 。 而 h 的 长 度 通 常 都 是 固定 的 ， 例 如 它 是 某 个 房间 的 冲击 响 
应 ， 或 者 是 某 种 FIR 滤 波 器 。 


根据 前 面 的 介绍 ， 为 了 有 效 地 利用 FFT 计 算 疮 积 ， 我 们 希望 它 的 两 个 输入 长 度 相 
当 ， 于 是 就 需要 对 信号 x 进 行 分 段 欠 理 。 对 疮 积 的 分 段 运算 被 称 作 : overlap-add 运 


o 


overlap-add 的 计算 方法 如 下 图 所 示 : 


分 段 卷 积 演示 


一 ， 滤 皮 器 系数 h l 
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原始 信号 x 长 度 为 300， 将 它 分 为 三 段 ， 分 别 与 滤波 器 系数 h 进 行 郑 积 计 算 ，h 的 长 度 
为 101， 因 此 每 段 输 出 200 个 数据 ， 图 中 用 绿色 标 出 每 段 输出 的 200 个 数据 。 这 3 段 
数据 按照 时 间 顺 序 进行 求 和 之 后 得 到 结果 和 原始 信号 的 耸 积 是 相同 的 。 


因此 将 持续 的 输入 信号 x 和 滤波 器 h 进 行 和 众 积 的 运算 可 以 按照 如 下 步骤 进行 ， 假 设 h 
的 长 度 为 M : 


1. 建立 一 个 缓存 ， 其 大 小 为 N+M-1， 初 始 值 为 0 

2. 每 次 从 x 中 读 取 N 个 数据 ， 和 h 进 行 郑 积 ， 得 到 N+M-1 个 数据 ， 和 缓存 中 的 数据 
进行 求 和 ， 并 放 进 缓存 中 ， 然 后 输出 缓存 前 N 个 数据 

3. 将 缓存 中 的 数据 向 左 移动 N 个 元 素 ， 也 就 是 让 缓存 中 的 第 N 个 元 素 成 为 第 0 个 元 
素 ， 后 面 的 N 个 元 素 全 部 设置 为 0 

4. 跳 转 到 2 重复 运行 


下 面 是 实现 这 一 算法 的 演示 程序 : 


# -*- coding: utf-8 -*- 
import numpy as np 


x = np.random.rand(1000) 
h = np.random.rand(101) 
y = np.convolve(x, h) 

N = # 分 段 大 小 

M = a # 滤波 器 长 度 
output = [] 
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buffer = np.zeros(M+N-1, dtype=np.float64) 


for i in xrange(len(x)/N): 
# 从 输入 信号 中 读 取 N 个 数据 
xslice = x[i*N:(i+1)*N] 
Hit RoR 
yslice = np.convolve(xslice, h) 
# 将 耸 积 的 结果 加 入 到 缓冲 中 
buffer += yslice 
# 输 出 缓存 中 的 前 N 个 数据 ， 注 意 使 用 copy， 否 则 输出 的 是 buffer 的 一 个 视图 
output.append( buffer[:N].copy() ) 


# 缓 存 中 的 数据 左 移动 N 个 元 素 
buffer[0:M-1] = buffer[N:] 
# 后 面 的 补 0 


buffer[M-1:] = 0 


# 将 输出 的 数据 组 合 为 数组 

y2 = np.hstack(output) 

# 计 算 和 直接 耸 积 的 结果 之 间 的 误差 

print np.sum(np.abs( y2 - y[:len(x)] ) ) 


注意 第 23 行 需要 输出 缓存 前 N 个 数据 的 拷贝 ， 否 则 输出 的 是 数组 的 一 个 视图 ， 当 此 
后 buffer 更 新 时 ， 视 图 中 的 数据 会 一 起 更 新 。 


将 FFT 快 速 耸 积 和 overlap-add 相 结合 ， 可 以 制作 出 一 些 快速 的 实时 数据 滤波 算法 。 

但 是 由 于 FFT 疮 积 对 于 两 个 长 度 相 当 的 数组 时 最 为 有 效 ， 因 此 在 分 段 时 也 会 有 所 限 

制 : 例如 如 果 滤 波 器 的 长 度 为 2048， 那 么 理想 的 分 段 长 度 也 为 2048， 如 果 将 分 段 

2 过 低 ， 反 而 会 增加 运算 量 。 因 此 在 实时 性 要 求 很 强 的 系统 中 ， 只 能 采用 
积 


Hilbert = 4% 


Hilbert% 换 能 在 振幅 保持 不 变 的 情况 下 将 输入 信号 的 相 角 偏 移 90 度 ， 简 单 地 说 就 是 
能 将 正弦 波形 转换 为 余弦 波形 ， 下 面 的 程序 验证 这 一 特性 : 


# -*- coding: utf-8 -*- 

from scipy import fftpack 
import numpy as np 

import matplotlib.pyplot as pl 


# 产生 1024 点 4 个 周期 的 正弦 波 
t = np.linspace(0, 8*np.pi, 1024, endpoint=False) 
x = np.sin(t) 


# 进行 Hilbert 变 换 

y = fftpack.hilbert(x) 
pl.plot(x，1label=u" 原 始 波 形 ") 
pl.plot(y，1label=u"Hilbert 转 换 后 的 波形 ") 
pl.legend() 

pl.show( ) 


关于 程序 的 几 点 说 明 : 


e hilbert##+*# NBN Escipy.fitpackE A = A 
。 为 了 生成 完美 的 正弦 波 ， 需 要 计算 整数 个 周期 ， 因 此 调用 linspace 时 指定 
endpoint=False， 这 样 就 不 会 包括 区 间 的 结束 点 : 8*np.pi 


此 程序 的 输出 图 表 如 下 ， 我 们 可 以 很 清楚 地 看 出 hilbert 将 正弦 波 变换 为 了 余弦 波 


形 。 


一 ”原始 波形 
— Hilbert 转换 后 的 波形 
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Hilbert 正 变换 的 相 角 偏 移 符号 

本 书 中 将 相 角 偏 移 +90 度 成 为 Hilbert 正 变换 。 有 的 文献 书籍 正好 将 定义 倒转 过 来 : 
将 偏 移 +90 度 成 为 Hilbert 负 变换 ， 而 偏 移 -90 度 成 为 Hilbert 正 变换 。 


相 角 偏 移 90 度 相当 于 复数 平面 上 的 点 与 虚数 单位 1j 相 乘 ， 因 此 Hilbert 变 换 的 频率 响 
应 可 以 用 如 下 公式 给 出 : 


H(w) = 7 - sgn(w) 
其 中 w ARM, sg A ASRA, Bl: 


1, for w > 0, 
sgn(w) = 0, forw=0, 
一 1， forw <0. 
我 们 可 以 将 其 频率 响应 理解 为 : 
。 直流 分 量 为 0 
。 正 频率 成 分 偏 移 +190 度 
© 负 频 率 成 分 偏 移 -90 度 


由 于 对 于 实数 信号 来 说 ， 正 负 闫 率 成 分 共 力 ， 因 此 对 实数 信号 进行 Hilbert 变 换 之 后 
仍然 是 实数 信号 。 下 面 的 程序 验证 Hilbert 变 换 的 频率 响应 : 


>>> x = np.random.rand(16) 
>>> y = fftpack.hilbert(x) 
>>> X = np. fft.fft(x) 
>>> Y = np.fft.fft(y) 


>>> np.imag(Y/X) 
rren Oop op op Mo Mo ar dan iaz 
Oop ley lee Sibop ae adop -1.]) 


对 信号 进行 N 点 FFT 变 换 之 后 : 


e。 下 标 为 0 的 频率 分 量 表 示 直 流 分 量 

e 下 标 为 N/2 的 的 频率 分 量 为 取样 频率 /2 的 频率 分 量 
e 1 到 N/2-1 为 正 频率 分 量 

© N/2+1 到 NN 为 负 频 率 分 量 


对 照 Y/X 的 虚数 部 分 ， 不 难看 出 它 是 符合 Hilbert 的 频率 响应 的 。 如 果 你 用 
np.real(Y/X) 观 察 实数 部 分 的 话 ， 它 们 全 部 接近 于 0。 


Hilbert 变 换 可 以 用 作 包 络 检 波 。 具 体 算法 如 下 所 示 : 





envelope = 


其 中 x 为 原始 载波 波形 ，H(x) 为 X 的 Hilbert 变 换 之 后 的 波形 ，envelope 为 信号 x 的 包 
络 。 其 原理 很 容易 理解 : 假设 x 为 正弦 波 ， 那 么 H(X) 为 余弦 波 ， 根 据 公式 : 


sin”(t) + cos*(t) =i 1 


可 知 envelope 恒 等 于 1， 为 sin(t) 信 和 号 的 包 络 。 下 面 的 程序 验证 这 一 算法 : 


# -*- coding: utf-8 -*- 
import numpy as np 

import pylab as pl 

from scipy import fftpack 


t np.arange(0, 0.3, 1/20000.0) 
x np.sin(2*np.pi*1000*t) * (np.sin(2*np.pi*10*t) + np.sin(2*np.p: 
hx = fftpack.hilbert(x) 


pl.plot(x, label=u"#3R(25") 

pl.plot(np.sqrt(x**2 + hx**2), "r", linewidth=2, label=u"#HHa4E 
pl.title(u" 使 用 Hilbert 变 换 进行 包 络 检 波 ") 

pl.legend() 

pl.show( ) 





使 用 Hilbert 变 换 进行 包 络 检 波 


一 ”载波 信号 
— 检 出 的 包 络 信号 
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使 用 Hilbert 变 换 对 载波 信号 进行 包 络 检 波 


at 
前 面 介绍 过 可 以 使 用 频率 打 描 波形 测量 滤波 器 的 频率 响 上 应， 我们 可 以 使 用 这 个 算法 
计算 出 打 描 波 的 包 络 : 


>>> run filter_lfilter_example01.py # 运行 滤波 器 的 例子 
>>> hy = fftpack.hilbert(y) 

>>> pl.plot( np.sqrt(y**2 + hy**2),"r", linewidth=2) 
>>> pl.plot(y) 

>>> plL.title(u" 频 率 扫 描 波 的 包 络 ") 

>>> pl.show() 


得 到 的 包 络 波形 如 下 图 所 示 : 


频率 扫描 波 的 包 络 
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使 用 Hilbert 变 换 对 频率 扫描 波 进 行 包 络 检 波 


eens 而 在 中 频 部 分 能 很 好 地 计算 出 
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Ctypes#]NumPy 
用 ctypes 加 速 计 算 


COPS yhon 态 链接 库 的 标准 扩展 模块 ， 在 Windows 下 使 用 它 可 以 直接 调 
用 C 语 言 编写 的 DLL 动态 链接 库 。 由 于 对 传递 的 参数 没有 类 型 和 越界 检查 ， 因 此 如 
果 编 写 的 代码 有 问题 的 话 ， 很 可 能 会 造成 程序 骨 溃 。 当 将 数组 数据 使 用 指针 传递 

时 ， 出 错误 的 风险 将 更 加 大 。 


为 了 让 程序 更 加 安全 ， 通 常会 用 Python 代码 对 Ctypes 调 用 进行 包装 ， 在 调用 Ctypes 
之 前 ， 在 Python 级 别 对 数据 类 型 和 越界 进行 检查 。 这 样 做 会 使 得 调用 接口 部 分 比 其 
它 的 一 些 手工 编写 的 扩展 模块 速度 要 慢 ， 但 是 如 果 C 语 言 的 代码 段 义理 相当 多 的 数 

据 的 话 ， 接 口 调用 部 分 的 速度 损失 是 可 以 忽略 不 计 的 。 


用 ctypes 调 用 DLL 


为 了 使 用 CTypes， 你 必须 依次 完成 以 下 步骤 : 
。 编写 动态 连接 库 程 序 
。 载 入 动态 连接 库 
e 将 Python 的 对 象 转换 为 ctypes 所 能 识别 的 参数 
e 使 用 ctypes 的 参数 调用 动态 连接 库 中 的 函数 


下 面 我 们 来 看 看 如 何 用 ctypes 调 用 动态 链接 库 。 


numpy 对 ctypes 的 支持 


为 了 方便 动态 连接 库 的 载 入 ，numpy 提 供 了 一 个 便捷 函数 ctypeslib.load _library。 它 
a o 第 一 个 参数 是 库 的 文件 名 ， 第 二 个 参数 是 库 所 在 的 路 径 。 函 数 返 回 的 
一 个 ctypes 的 对 象 。 通 过 此 对 象 的 属性 可 以 直接 到 动态 连接 库 所 提供 的 函数 。 


例如 如 果 我 们 有 一 个 库 名 为 test_sum.dll， 其 中 提供 了 一 个 函数 mysum : 


double mysum(double a[], long n) 
{ 
double sum = 0; 
int i; 
for(i=0;i<n;i++) sum += a[i]; 
return sum; 


的 话 ， 我 们 可 以 使 用 如 下 语句 载 入 此 库 : 


>>> from ctypes import * 

>>> sum_test = np.ctypeslib.load_library("sum_test", ".") 
>>> print sum_test.mysum 

<_FuncPtr object at 0x037D7210> 


要 正确 调用 sum 函 数 ， 还 必须 对 其 参数 类 型 进行 说 明 ， 下 面 的 语句 描述 了 sum 男 数 
的 两 个 参数 的 类 型 和 返回 值 的 类 型 进行 描述 : 


>>> sum_test.mysum.argtypes = [POINTER(c_double), c_long] 
>>> sum_test.mysum.restype = c_double 


接 下 来 就 可 以 正常 调用 sum 画 数 了 : 


>>> x = np.arange(1, 101, 1.0) 
>>> sum_test.mysum(x.ctypes.data_as(POINTER(c_double)), len(x)) 
5050.0 


每 次 调用 sum 都 需要 进行 类 型 转换 时 比较 麻烦 的 事情 ， 因 此 可 以 编写 一 个 Python 的 
mysum žit, CSS MhmysumW a ase: 


def mysum(x): 
return sum_test.mysum(x.ctypes.data_as(POINTER(c_double)), leni 
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在 上 面 的 例子 中 ，test_sum.mysum 的 参数 值 使 用 标准 的 ctypes 类 型 声明 : 用 
POINTER(c_double) 声 明 mysum 画 数 的 第 一 个 参数 是 一 个 指向 double 的 指针 ; 然后 
调用 数组 x 的 x.ctypes.data_as 画 数 将 x 转 换 为 一 个 指向 double 的 指针 类 型 。 


由 于 数组 的 元 素 在 内 存 中 的 存储 可 以 是 不 连续 的 ， 而 且 可 以 是 多 维 数 组 ， 因 此 我 们 
不 能 指望 前 面 的 mysum 函 数 能 够 处 理 所 有 的 情况 





>>> x = np.arange(1,11,1.0) 
>>> mysum(x[::2]) 

15.0 

>>> sum(x[::2]) 

25.0 


由 于 x[::2] 和 x 共 同一 块 内 存 空 间 ， 而 x[::2] 中 的 元 素 是 不 连续 的 ， 每 个 元 素 之 间 的 间 
隔 为 16byptes(2 个 double 的 大 小 )。 因此 将 它 传 递 给 mysum 的 话 ， 实 际 上 计算 的 是 x 
数组 中 前 5 项 的 和 : 1+2+3+4+5=15， 而 实际 上 我 们 希望 的 结果 是 : 
1+3+5+7+9=25。 


为 了 对 传递 的 数组 参数 进行 更 加 详细 的 描述 ，numpy 库 提供 了 ndpointer 函 数 。 
ndpointer 函 数 对 restype 和 argtypes 中 的 数组 参数 进行 描述 ， 他 有 如 下 4 个 参数 : 


dtype : 数组 的 元 素 类 型 

ndim : 数组 的 维 数 

shape : 数组 的 形状 ， 各 个 轴 的 长 度 
flags : 数组 的 标志 


例如 : 


test_sum.mysum.argtypes = [ 
np.ctypeslib.ndpointer(dtype=np.float64, ndim=1, flags="C_CONT: 
c_long 


-D 








描述 了 sumfunc 函 数 的 参数 为 一 个 元 素 类 型 为 double 的 、 一 维 的 、 连 续 的 元 素 按 C 
语言 规定 排列 的 数组 。 


这 时 传递 给 mysum 本 数 的 第 一 个 参数 可 以 直接 是 数组 ， 因 此 无 需 再 编写 一 个 Python 
函数 对 其 进行 包装 : 


>>> sum_test.mysum(x, LIen(Xx)) 

55.0 

>>> sum_test.mysum(x[::2],len(x)/2) 

ArgumentError: argument 1: <type 'exceptions.TypeError'>: 
array must have flags ['C_CONTIGUOUS' ] 


我 们 注意 到 如 果 参 数 数组 不 是 连续 空间 的 话 ，mysum 函 数 的 调用 会 抛 出 异常 错误 ， 
提醒 我 们 其 参数 需要 C 语 言 排列 的 连续 数组 。 


如 果 我 们 希望 它 能 够 处 理 多 维 、 不 连续 的 数组 的 话 ， 就 需要 把 数组 的 shape 和 
strides 属 性 都 传递 给 过 去 。 假 设 我 们 想 写 一 个 通用 的 mysum2 画 数 ， 它 可 以 对 二 维 
数组 的 所 有 元 素 进 行 求 和 。 下 面 是 C 话 言 的 程序 : 


double mysum2(double a[], int strides[], int shapes[]) 
{ 

double sum = 0; 

Ime a, a Mie iN, Se.) Si; 

M = shape[0]; N=shape[1]; 
SO = strides[0] / sizeof(double); 
S1 = strides[1] / sizeof(double); 
for (i=0; i<M;i++){ 

for (j=0;J<N; j++) { 

sum += a[i*SO + j*S1]; 
} 


} 


return sum; 


mysum2 HAEINSA, BABAE RTR AGRAR ; 第 二 个 参数 
astrides 指 向 保存 数组 各 个 轴 元 素 之 间 的 间隔 (以 byte 为 单位 ) ; 第 三 个 参数 dims 指 向 
保存 数组 各 个 轴 长 度 的 数组 。 


由 于 strides 保 存 的 是 以 byte 为 单位 的 间隔 长 度 ， 因 此 需要 除 以 sizeof(double) 计 算出 
以 double 为 单位 的 间隔 长 度 S0 和 S1。 这 样 二 维 数组 a 中 的 第 i 行 、 第 j 列 的 元 素 可 以 
通过 a[liSO + jS1] 来 存 取 。 下 面 用 ctypes 对 mysum2 豆 数 进行 包装 : 


sum_test.mysum2.restype = c_double 

sum_test.mysum2.argtypes = [ 
np.ctypeslib.ndpointer(dtype=np.float64, ndim=2), 
POINTER(c_int), 
POINTER(c_int) 

] 


def mysum2(x): 
return sum_test.mysum2(x, x.ctypes.strides, x.ctypes.shape) 


fEmysum2WA, #4 了 将 数组 x 的 strides 和 shape 属 性 传递 给 CHER, PA 
使 用 x.ctypes 中 提供 的 strides 和 shape 属 性 。 注 意 不 能 直接 传递 Xx.strides 和 

x.shape， 因 为 这 些 是 python 的 tuple 对 象 ， 而 x.ctypes.shape 得 到 的 是 ctypes 包 装 的 
整数 数组 : 


>>> x = np.zeros((3,4), np.float) 

>>> x.ctypes.shape 

<numpy.core._internal.c_long_Array_2 object at Ox020B4DFO> 
>>> S = x.ctypes.shape 

>>> s[0] 

3 

>>> s[1] 

4 





可 以 看 出 x.ctypes.shape 是 一 个 有 两 个 元 素 的 C 语 言 长 整 型 数组 。 虽 然 我 们 也 可 以 在 
Python 中 通过 下 标 读 取 其 各 个 元 素 的 值 ， 但 是 通常 它们 是 作为 参数 传递 给 C 语 言 可 
数 用 的 。 


目 适 应 滤波 器 和 NLMS 模 拟 


本 章 将 简要 介绍 自 适 应 滤波 器 的 原理 以 及 其 最 常用 的 算法 NLMS， 并 给 NLMS 算 法 
的 两 种 实现 方法 : 用 纯 Python 编 写 ， 和 用 ctypes 调 用 C 语 言 编写 。 最 后 冯 对 NLMS 
算法 进行 一 些 的 实验 。 


自 适 应 滤波 器 简介 


近年 来 ， 随 着 数字 信号 处 理 器 的 功能 的 不 断 增 强 ， 自 适应 信号 义理 (adaptive signal 
process) 活 路 在 噪声 消除 、 回 声控 制 、 信 号 预测 、 声 音 定位 等 众多 信号 义理 领 域 。 


尽管 其 应 用 领域 十 分 广泛 ， 但 基本 的 系统 构造 大 致 只 有 如 下 几 种 分 类 。 


系统 辨识 


所 谓 系 统 辨识 (system identification)， 就 是 通过 对 未 知 系统 的 输入 输出 进行 观测 ， 
构造 一 个 滤波 器 使 得 它 在 同样 的 输入 的 情况 下 ， 输 出 信号 和 未 知 系统 相同 。 简 而 言 
之 ， 就 是 通过 观测 未 知 系统 对 输入 的 反应 ， 探 知 其 内 部 情况 。 为 了 探知 内 情 而 使 用 
的 输入 信号 我 们 称 之 为 参照 信号 。 


n(j) | 


x(j) y(j) 
> 


未 知 系统 e(j) 





+ > + 
自 适应 滤波 器 ol 


fue 
系数 更 新 算法 








系统 识别 (system identification) 框 图 
系统 识别 (System Identification Kt A 
如 上 图 所 示 参 照 信 号 x() 同 时 输入 到 未 知 系统 和 自 适 应 滤波 器 H 中 ， 未 知 系 统 的 输出 
Ay(j), 自 适 应 滤波 器 的 输出 为 u(j)， 由 于 观测 误差 或 者 外 部 噪声 的 干扰 ， 实 际 观测 
到 的 未 知 系统 的 输出 为 d()=y(j)+n()，n() 被 称 为 外 部 干扰 。 通 过 求 的 dj) 和 u(j) 之 间 
的 误差 e()=d()-u(j)， 我 们 可 以 知道 自 适 应 滤波 器 H 和 未 知 系统 还 有 多 少 差 别 ， 通 过 
这 个 误差 我 们 更 新 H 的 内 部 参数 ， 使 得 它 更 加 靠近 未 知 系统 。 
上 面 各 个 公式 中 的 j 表 示 某 一 时 刻 ， 因 为 我 们 讨论 的 是 数字 信号 人 处理， 已 经 对 所 有 的 
信号 进行 取样 ， 因 此 可 以 把 j 简 单 的 看 作 取 样 点 的 下 标 。 


信号 预测 


所 谓 信 号 预测 就 是 通过 信号 过 去 的 值 预测 (计算 ) 现在 的 值 ， 下 面 是 信号 预测 的 系 
统 框 图 。 


x(j) d(j) e(j) 
E + na SS > 
| x(j-D) u(j) 
n(j) 延迟 器 自 适 应 滤波 器 


Tacs) 
系数 更 新 算法 。 * 一 一 一 一 


信号 预测 (prediction) 框 图 








信号 预测 (Predication) 框 图 

x(j) 是 待 预测 的 信号 ， 假 设 我 们 无 法 完美 地 观测 此 信号 ， 因 此 导入 一 个 外 部 干扰 
n()， 这 样 d()=x(j)+ngd) 就 是 我 们 观测 到 的 待 预测 信号 。 
通 


通过 延迟 器 将 d() 进 行 延 时 得 到 d(j-D)， 并 把 d(-D) 输 入 到 自 适 应 滤波 器 H 中 ， 得 到 其 
输出 为 u(j)，u(j) 就 是 自 适 应 滤波 器 通过 待 预 测 信号 过 去 的 值 预 测 出 的 现在 的 值 ， 计 
算 观 测 值 d(j) 和 预测 值 u(j) 之 间 的 误差 e(j)=d(j)-u(j)， 通 过 e(j) 更 新 自 适 应 滤波 器 H 的 内 
部 系数 使 得 其 输出 更 加 接近 d(j)。 

如 果 x(j) 存 在 白色 噪声 的 成 分 和 周期 信号 的 成 分 ， 由 于 白色 噪声 是 完全 不 自 相 关 ， 无 
法 预测 的 信号 ， 因 此 通过 过 去 的 值 x(j-D) 所 能 预测 的 只 能 是 其 中 的 周期 信号 的 成 
分 。 这 样 自 适应 滤波 器 H 的 输出 信号 u(j) 就 会 与 周期 信号 成 分 渐渐 逼近 ， 而 e() 则 是 
剩 下 的 不 可 预测 的 白色 噪声 的 成 分 。 因 此 自 适 应 滤波 器 也 可 以 运用 于 噪声 消除 。 


信号 均衡 


x(j) d(j)=x(j-D) 
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信号 均衡 (equalization) 框 图 








信号 均衡 (Equalization) 框 图 


当 信 号 x(j) 通 过 未 知 系统 之 后 变 成 yj)， 未 知 系统 对 信号 x(j) 进 行 了 某 种 改变 ， 使 得 其 
波形 产生 重 曲 。 我 们 希望 均衡 器 矫正 这 种 焉 曲 ， 也 就 是 通过 y(j) 重 建 原始 信 号 x(j)， 
由 于 因果 律 还 原 原 始 信号 x(j) 是 不 可 能 的 ， 我 们 只 能 还 原 其 延 时 了 的 信号 x0-D)。x(j) 
和 x(j-D) 除 了 时 间 上 的 延迟 之 外 ， 其 它 特性 完全 相同 。 


这 里 我 们 将 观测 到 的 未 知 系统 的 输出 y(j)+n() 输 入 到 自 适 应 滤波 器 H 中 ， 通 过 H 的 系 
数 更 新 使 得 其 输出 u() 逐 渐 逼 近 原 始 信号 的 延 时 x(j-D)。 这 样 我 们 就 构建 了 一 个 滤波 
器 H 使 得 它 与 未 知 系统 的 卷 积 正好 等 于 一 个 脉冲 传递 画 数 。 也 就 是 说 H 的 频 域 特性 
恰好 能 抵消 未 知 系统 的 所 带 来 的 改变 。 


NLMS 计 算 公 陈 


自 适 应 滤波 器 中 最 重要 的 一 个 环节 就 是 其 系数 的 更 新 算法 ， 如 果 不 对 自 适应 滤波 器 
的 系数 更 新 的 话 ， 那 么 它 就 只 是 一 个 普通 的 FIR 滤 波 器 了 。 系 数 更 新 算法 有 很 多 种 
类 ， 最 基本 、 常 用 、 简 单 的 一 种 方法 叫做 NLMS( 为 一 化 最 小 均 方 )， 让 我 们 先 来 看 
看 它 的 数学 公式 表达 : 


设置 自 适应 滤波 器 系数 h 的 所 有 初始 值 为 0, h 的 长 度 为 |。 


h(0) =0 
对 每 个 取样 值 进行 如 下 计算 ， 其 中 n=0, 1, 2, ... 
x(n) = [z(n),2(n—1),...,: r(n— I +1) 


自 适应 滤波 器 系数 h 是 一 个 长 度 为 | 的 矢量 ， 也 就 是 一 个 长 度 为 | 的 FIR 滤 波 器 。 在 时 
刻 n， 滤 波 器 的 每 个 系数 对 应 的 输入 信号 为 X(2) ， 它 也 是 一 个 长 度 为 | 的 矢量 。 这 两 
个 矢量 的 点 乘 即 为 滤波 器 的 输出 和 目标 信号 d(n) 之 间 的 差 为 e(n)， 然 后 根据 e(n) 和 
x(n), 更 新 滤波 器 的 系数 。 

数学 公式 总 是 舍 人 难以 理解 的 ， 下 面 我 们 以 图 示 为 例 进行 说 明 : 


powerX= x[4]*x[4]+...+x[7]*x[7] 
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h[4]=h[4]+u *e[7]*x[4]/powerx 


NLMS 算 法 示意 图 
图 中 假设 自 适 应 滤波 器 h 的 长 度 为 4， 在 时 刻 7 滤 波 器 的 输出 为 : 


u[7] = h[0]*x[7] + h[1]*x[6] + h[2]*x[5] + h[3]*x[4] 
滤波 器 的 输入 信号 的 平方 和 powerX 为 : 

powerX = x[4]*x[4] + x[5]*x[5] + x[6]*x[6] + x[7]*x[7] 
未 知 系统 的 输出 d[7] 和 滤波 器 的 输出 u[7] 之 间 的 差 为 : 

e[7] = d[7] - u[7] 


使 用 u[7] 和 x[4]..x[7] 对 滤波 器 的 系数 更 新 : 


h[4] = h[4] + u * e[7]*x[4]/powerx 
h[4] = h[5] + u * e[7]*x[5]/powerx 
h[4] = h[6] + u * e[7]*x[6]/powerx 
h[4] = h[7] + u * e[7]*x[7]/powerx 


其 中 参数 u 成 为 更 新 系数 ， 为 0 到 1 之 间 的 一 个 实数 ， 此 值 越 大 系数 更 新 的 速度 越 
快 。 对 于 每 个 时 刻 i 都 需要 进行 上 述 的 计算 ， 因 此 洪波 器 的 系数 对 于 每 个 参照 信号 x 
的 取样 都 更 新 一 次 。 


NumPy 实 现 


按照 上 面 介 绍 的 NLMS 算 法 ， 我 们 很 容易 写 出 用 NumPy 实 现 的 NLMS 计 算 程 序 : 


# -*- coding: utf-8 -*- 
# filename: nilms_numpy.py 


import numpy as np 


# 用 Numpy 实 现 的 NLMS 算 法 

# X 为 参照 信号 ，d 为 目标 信号 ，h 为 自 适 应 滤波 器 的 初 什 
# step_size 为 更 新 系数 

def nlms(x, d, h, step_size=0.5): 


i = len(h) 
size = len(x) 
# 计算 输入 到 h 中 的 参照 信号 的 乘 方 he 


power = np.sum( x[i:i-len(h):-1] * x[i:i-len(h):-1] ) 
u = np.zeros(size, dtype=np.float64) 


while True: 
X_input = x[i:i-len(h):-1] 
u[i] = np.dot(x_input , h) 
= d[i] - u[i] 
h += step_size * e / power * x_input 


power -= xX_input[-1] * x_input[-1] # 减 去 最 早 的 取样 
工 += 工 

if i >= size: return u 

power += x[i] * x[i] # 增加 最 新 的 取样 


为 了 节省 计算 时 间 ， 我 们 用 一 个 临时 变量 power 保 存 输 入 到 滤波 器 h 中 的 参照 信号 x 
的 能 量 。 在 对 于 x 中 的 每 个 取样 的 循环 中 ，power 减 去 x 中 最 早 的 一 个 取样 值 的 乘 
方 ， 增 加 最 新 的 一 个 取样 值 的 乘 方 。 这 样 为 了 计算 参照 信号 的 能 量 ， 每 次 循环 只 需 
要 计算 两 次 乘法 和 两 次 加 法 即 可 。 


niIms 范 数 的 输入 为 参照 信号 x、 目 标 信号 d 和 自 适应 滤波 器 的 系数 h。 因 为 在 后 面 的 
模拟 计算 中 ，d 是 x 和 未 知 系统 的 脉冲 响应 的 卷 积 而 计算 的 来 ， 它 的 长 度 会 大 于 x 的 
参数 ， 因 此 循环 体 的 循环 次 数 以 参照 信号 的 长 度 为 基准 。 


为 了 对 自 适应 滤波 器 的 各 种 应 用 进行 模拟 ， 我 们 还 需要 如 下 的 几 个 辅助 钞 数 ， 完 整 
的 程序 请 参考 NLMS 算 法 的 模拟 测 i | ix o 


def make_path(delay, length): 
path_length = length - delay 
h = np.zeros(length, np.float64) 
h[delay:] = np.random.standard_normal(path_length) * np.exp( np 
h /= np.sqrt(np.sum(h*h)) 
return h 


-| ë R 


make_path 产 生 一 个 长 度 为 length， 最 小 延 时 为 delay 的 指数 衰减 的 波形 。 这 种 波形 
和 封 ie 空间 的 声音 的 传递 函数 有 些 类 似 之 处 ， 因 此 在 计算 机 上 进行 声音 的 算法 模拟 
时 经 常用 这 种 波形 作为 系统 的 传递 AL, 





def plot_converge(y, u, label=""): 
size = len(u) 
avg_number = 200 
e = np.power(y[:size] - u, 2) 
tmp = e[:int(size/avg_number )*avg_number ] 
tmp.shape = -1, avg_number 
avg = np.average( tmp, axis=1 ) 
pl.plot(np.linspace(0, size, len(avg)), 10*np.logi@(avg), linev 


def diff_db(ho, h): 
return 10*np.logi0(np.sum((hO-h)*(hO-h)) 7 np.sum(h0*hO) ) 


‘| 一 








plot _converge 绘 制 信号 y 和 信号 u 之 间 的 误差 ， 每 avg_number 个 取样 点 就 上 一 次 误 
差 的 乘 方 的 平均 值 。 我 们 将 用 plot converge 本 数 绘制 未 知 系统 的 输出 y 和 自 适 应 滤 
波 器 的 输出 u 之 间 的 误差 。 观 察 自 适应 滤波 器 是 如 何 收敛 的 ， 以 评价 自 适 应 滤波 器 
的 收 化 特性 。diff_db 琅 数 同样 是 用 来 评价 自 适应 滤波 器 的 收 伍 特 性 ， 不 过 他 是 直接 
计算 未 知 系统 的 传递 画 数 h0 和 自 适应 滤波 器 的 传递 男 数 h 之 间 的 误差 。 下 面 我 们 会 
看 到 这 两 个 函数 得 到 的 收 伊 值 是 相同 的 。 


系统 辨识 模拟 
我 们 用 下 面 的 函数 调用 nlms 算 法 对 系统 辨识 应 用 进行 模拟 : 


def sim_system_identify(nlms, x, hO, step_size, noise_scale): 

= np.convolve(x, h0) 

y + np.random.standard_normal(len(y)) * noise_scale # 添 
np.zeros(len(hO), np.float64) # 自 适 应 滤波 器 的 长 度 和 未 知 系 统 
nlms( x, d, h, step_size ) 

eturn y, u, h 
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自 适应 滤波 器 
ie 
系数 更 新 算法 
系统 识别 (system identification) 框 图 
系统 识别 (System Identification) 的 框 
TERMS FA : 


e nims : nims AEI K wR 

© X: 参照 信号 

e。h0 : 未 知 系统 的 传递 酌 数 ， 虽 然 是 未 知 系统 ， 但 是 计算 机 模拟 时 它 是 已 知 的 

e step_size : nlms 算 法 的 更 新 系数 

e noise_scale: 外 部 干扰 的 系数 ， 此 系数 决定 外 部 干扰 的 大 小 ，0 表 示 没 有 外 部 
干扰 


函数 的 返回 值 分 别 为 


ey: 未 知 系统 的 输出 ， 不 包括 外 部 干扰 
。U : 自 适应 滤波 器 的 输出 
eh: 自 适应 滤波 器 的 最 终 的 系数 


最 后 我 们 用 下 面 的 函数 创建 未 知 系统 h0， 参照 信号 x， 然 后 调用 
sim_system_identify 玉 数 得 到 结果 并 且 绘 图 : 


def system_identify_test1(): 
ho = make_path(32, 256) # BEI > E-FRARAN HBR 
x = np.random.standard_normal(10000) # 参照 信号 为 白 噪 声 
y, u, h = sim_system_identify(nlms_numpy.nlms, x, hO, 0.5, 0.1 
print diff_db(h0, h) 
pl.figure( figsize=(8, 6) ) 
pl.subplot(211) 
pl.subplots_adjust(hspace=0.4) 
pl.plot(h0, c="r") 
pl.plot(h, c="b") 
pl.title(u" 未 知 系 统 和 收敛 后 的 滤波 器 的 系数 比较 ") 
pl.subplot( 212) 
plot_converge(y, u) 
pl.title(u" 自 适应 滤波 器 收 仇 特性 " ) 
pl.xlabel("Iterations (samples)") 
pl.ylabel("Converge Level (dB)") 
pl.show( ) 


4 = = = LA 


未 知 系统 和 收敛 后 的 滤波 器 的 系数 比较 


自 适应 滤波 器 收敛 特性 


—15 


Converge Level (dB) 
N 
© 


| 
N 
vI 


| 
w 
© 


2000 4900 6000 8000 10000 
Iterations (samples) 


自 适 应 滤波 器 收敛 之 后 的 系数 和 收 化 速 度 


上 部 的 图 显示 的 是 未 知 系统 (红色 ) 和 自 适 应 滤波 器 ( 蓝 色 ) 的 传递 本 数 的 系数 ， 我 们 看 
到 自 适 应 滤波 器 已 经 十 分 接近 未 知 系统 了 。diff_db(h0, h) 的 输出 为 -25.35dB。 下 部 
的 图 通过 绘制 y 和 u 之 间 的 误差 ， 显 示 了 自 适 应 滤波 器 的 收 化 过 程 。 我 们 看 到 经 过 缴 
3000 点 的 计算 之 后 ， 收 敛 过 程 已 经 人 饱和， 最 终 的 误差 为 -25dB 左 右 ， 和 diff db 计算 
的 结果 一 致 。 


从 图 中 可 以 看 到 收敛 过 程 的 两 个 重要 特性 : 收敛 时 间 和 收敛 精度 。 参 照 信 号 的 特 
性 、 外 部 干扰 的 大 小 和 更 新 系数 都 会 影响 这 两 个 特性 。 下 面 让 我 们 看 看 参照 
白色 噪声 、 外 部 干扰 的 能 量 固定 时 ， 更 新 系数 对 它们 影响 : 


def system_identify_test2(): 
ho = make_path(32, 256) # BE > E-*FRARAN HBR 
x = np.random.standard_normal(20000) # 参照 信号 为 白 噪 声 
pl.figure(figsize=(8,4)) 
for step_size in np.arange(0.1, 1.0, 0.2): 
y, u, h = sim_system_identify(nlms_numpy.nlms, x, hO, step_ 
plot_converge(y, u, label=u"y=%s" % step_size) 
pl.title(u" 更 新 系数 和 收敛 特性 的 关系 ") 
pl.xlabel("Iterations (samples)") 
pl.ylabel("Converge Level (dB)") 
pl.legend() 
pl.show( ) 








更 新 系数 和 收敛 特性 的 关系 
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更 新 系数 和 收敛 速度 的 关系 
下 面 是 更 新 系数 固定 ， 外 部 干扰 能 量变 化 时 的 收敛 特性 : 


def system identify test3(): 

ho = make_path(32, 256) # 随机 产生 一 个 未 知 柔 统 的 传递 函数 

x = np.random.standard_normal(20000) # 参照 信号 为 白 噪声 

pl.figure(figsize=(8,4)) 

for noise_scale in [0.05, 0.1, 0.2, 0.4, 0.8]: 
y, u, h = sim_system_identify(nlms_numpy.nlms, x, he, 0.5, 
plot_converge(y, u, label=u"noise=%s" % noise_scale) 

pl.title(u" 外 部 干扰 和 收敛 特性 的 关系 ") 

pl.xlabel("Iterations (samples)") 

pl.ylabel("Converge Level (dB)") 

pl.legend() 

pl.show( ) 
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外 部 干扰 噪声 和 收敛 速度 的 关系 


从 上 面 的 图 可 以 看 出 ， 当 外 部 干扰 的 振幅 增加 一 倍 、 能 能 量 增加 6dB 时 ， 收 敛 精度 
降低 6dB。 而 由 于 更 新 系数 相同 ， 所 以 收 化 过 + 程 中 的 收效 速度 都 是 一 样 的 。 


信号 均衡 模拟 
对 于 信号 均衡 的 应 用 我 们 用 如 下 的 程序 进行 模拟 : 


def sim_signal_equation(nlms, x, hO, D, step_size, noise_scale): 


d = x[:-D] 

x = x[D:] 

y = np.convolve(x, h0O)[:len(x)] 

h = np.zeros(2*len(h0)+2*D, np.float64) 

y += np.random.standard_normal(len(y)) * noise_scale 
u = nlms(y, d, h, step_size) 

return h 


x(j) d(j)=x(j-D) 
[o md 
T e(j) 
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信号 均衡 (Equalization) 框 图 


sim_signal_equation AWE : 
。 nims : nims AHI K wR 


x: 未 知 系统 的 输入 信号 

h0 : 未 知 系统 的 传递 图 数 

D : 延迟 器 的 延 时 参数 

step_size : niIms 算 法 的 更 新 系数 

noise_scale : 外 部 干扰 的 系数 ， 此 系数 决定 外 部 干扰 的 大 小 ，0 表 示 没 有 外 部 
干扰 


在 函数 中 的 各 个 局 部 变量 : 
ed: 输入 信号 经 过 延迟 器 之 后 的 信号 
ey: 未 知 系统 的 输出 
e h : 自 适 应 滤波 器 的 系数 ， 它 的 长 度 要 足够 长 ， 程 序 中 使 用 2 倍 延 时 + 2 倍 未 知 
系统 的 传递 画 数 的 长 度 
画 数 的 返回 值 为 自 适 应 滤波 器 收 仇 后 的 系数 ， 它 能 够 均衡 h0 对 输入 信号 所 造成 的 影 
响 。 我 们 通过 下 面 的 函数 产生 数据 、 调 用 模拟 函数 以 及 绘制 结果 : 


def signal_equation_test1(): 
ho = make_path(5, 64) 
D = 128 
length = 20000 
data = np.random.standard_normal(length+D) 
h = sim_signal_equation(nlms_numpy.nlms, data, hO, D, 0.5, 0.1 
pl.figure(figsize=(8,4)) 
pl.plot(ho0, label=u"AHWMA") 
pl.plot(h, label=u" B38 & 38325") 
pl.plot(np.convolve(h0, h), label=u"—[##R") 
pl.title(u" 信 号 均衡 演示 ") 
pl.legend() 
w0, HO = scipy.signal.freqz(h0, worN = 1000) 
w, H = scipy.signal.freqz(h, worN = 1000) 
pl.figure(figsize=(8,4)) 
pl.plot(w0, 20*np.log10(np.abs(HO)), w, 20*np.1logi0(np.abs(H))_ 
pl1.tit1le(u" 未 知 系统 和 自 适 应 滤波 器 的 振幅 特性 " ) 
pl.xlabel(u" Am") 
pl.ylabel(u" 振 幅 (dB)") 
pl. show() 


-| ~. 
如 果 延 迟 器 的 延 时 D 不 够 的 话 ， 会 由 于 因果 律 使 得 自 适 应 滤波 器 无 法 收 仇 。 因 此 这 


里 我 们 采用 的 D 的 长 度 为 h0 的 长 度 的 2 倍 。 下 图 显示 h0, h 和 它们 的 疮 积 。 我 们 看 到 
h0 和 h 的 众 积 正好 是 一 个 脉冲 ， 其 延 时 为 正好 等 于 D(128)。 





信号 均衡 演示 


未 知 系统 
自 适应 滤波 器 
二 者 卷 积 





未 知 系统 和 自 适 应 滤波 器 的 级 联 ( 疮 积 ) 近 似 为 标准 延迟 


下 图 显示 未 知 系统 的 频率 响应 ( 蓝 色 ) 和 自 适应 滤波 器 的 频率 响应 (绿色 )， 我 们 看 到 二 
者 正好 相反 ， 也 就 是 说 自 适应 滤波 器 均衡 了 未 知 系 统 对 信号 的 影响 。 


未 知 系统 和 自 适 应 滤波 器 的 振幅 特性 
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加 频率 
未 知 系统 和 自 适 应 滤波 器 的 频率 响应 正好 相反 


Baws 


& KB wA RAR SAA A AIMERA R, AMARPHUMBAMTAEEA 
ATA. RUIE ADATE RA ANIA hA LARA ET AY BP h ee AAS AR it 
算 求 得 ， 而 所 谓 众 积 的 逆 运算 可 以 想象 为 已 知 h3 和 h1， 求 一 个 h2 使 它 和 h1 级 联 之 
后 正好 等 于 h3。 


根据 肉 积 的 计算 公式 可 知 ， 如 果 h1 的 长 度 为 100，h3 的 长 度 为 199， 那 么 h2 的 长 度 
则 为 100， 因 为 h2 的 每 个 系数 都 是 未 知 的 ， 于 是 就 有 100 个 未 知 数 ， 而 这 100 个 未 知 
数 需要 满足 199 个 线性 方程 : h3 中 的 每 个 系数 都 有 一 个 方程 与 之 对 应。 由 于 方程 数 


大 于 未 知 数 的 个 数 ， 显 然 对 于 任意 的 h1 和 h3 并 不 能 保证 有 一 个 h2 使 得 它 和 h1 的 疮 
积 正好 等 于 h3。 


既然 不 能 精确 求解 ， 那 么 肉 积 的 道 运算 就 变 成 了 一 个 误差 最 小 化 的 优化 问题 。 用 自 
适应 滤波 器 计算 央 积 的 逆 运 算 和 计算 信号 均衡 类 似 ， 将 白色 噪声 x 输 入 到 h1 中 得 到 
信号 u， 将 x 输 入 到 h3 中 得 到 信号 d， 然 后 使 用 u 作 为 参照 信号 ，d 作 为 目标 信号 进行 
NLMS 计 算 ， 最 终 收 化 后 的 自 适应 滤波 器 的 系数 就 是 h2。 


下 面 的 程序 模拟 这 一 过 程 : 


# -*- coding: utf-8 -*- 
import numpy as np 

import pylab as pl 

from nilms_numpy import nlms 
import scipy.signal as signal 


def inv_convolve(h1, h3, length): 


x = np.random.standard_normal(10000) 
u = signal.1lfilter(hi, 1, x) 

d = signal.lfilter(h3, 1, x) 

h = np.zeros(length, np.float64) 


nlms(u, d, h, 0.1) 
return h 


h1 = np.fromfile("h1i.txt", sep="\n") 
hi /= np.max(h1) 
h3 = np.fromfile("h3.txt", sep="\n") 
h3 /= np.max(h3) 


pl.rc('legend', fontsize=10) 

pl.subplot (411) 

pl.plot(h3, label="h3") 

pl.plot(h1, label="h1") 

pl.legend() 

pl.gca().set_yticklabels([]) 

for idx, length in enumerate([128, 256, 512]): 
pl.subplot(412+idx) 
h2 = inv_convolve(h1, h3, length) 
pl.plot(np.convolve(hi, h2)[:len(h3)], label="h1*h2(%s)" % len‘ 
pl.legend() 
pl.gca().set_yticklabels([]) 
pl.gca().set_xticklabels([]) 


pl.show( ) 
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下 面 是 程序 的 计算 结果 : 
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BAr A A 
程序 中 的 h1 和 h3 从 文本 文件 中 读 取 而 得 ， 它 们 是 ANC( 能 动 噪声 控制 ) 系 统 中 实际 测 


量 的 脉冲 响应 。 如 果 能 找到 一 个 h2 满 足 郑 积 条 件 的 话 ， 就 能 够 有 效 的 进行 噪声 控 
制 


o 


程序 计算 出 h2 的 长 度 分 别 为 128, 256, 512 时 的 结果 ， 可 以 看 出 h2 越 长 结果 越 精 确 。 
DLL 函数 的 编写 


ctypes 的 python 接 口 


单 摆 和 双 摆 模拟 


单 摆 模 拟 
由 一 根 不 可 伸 长 、 质 量 不 计 的 绳子 ， 上 端 固定 ， 下 端 系 一 质点 ， 这 样 的 装置 叫做 单 
摆 。 
0、 
VL 


单 摆 装 置 示意 图 
根据 牛顿 力学 定律 ， 我 们 可 以 列 出 如 下 微分 方程 : 


dé 
dt? 


其 中 8 为 单 摆 的 摆 角 ， 为 单 摆 的 长 度 ， g 为 重力 加 速度 。 
此 微分 方程 的 符号 解 无 法 直接 求 出 ， 因 此 只 能 调用 odeint 对 其 求 数 值 解 。 
odeint 范 数 的 调用 参数 如 下 : 





q 
$sing = = 0 


odeint(func, yO, t, ...) 


EBAfunce—*Pythony Wat, AR RMOABARSTAA WANS, 
yVOAMADARAASTAMWAN Mea, tABEZRODEAKRAN AR. CIRO 
的 是 一 个 二 维 数 组 result， 其 第 0 轴 的 长 度 为 t 的 长 度 ， 第 1 轴 的 长 度 为 变量 的 个 数 ， 
因此 resulti, i] 4 Bis AWAY AF. 


计算 微分 的 func 画 数 的 调用 参数 为 ; func(y, t)， 其 中 y 是 一 个 数组 ， 为 每 个 未 知 函 
数 在 t 时 刻 的 值 ， 而 func 的 返回 值 也 是 数组 ， 它 为 每 个 未 知 画 数 在 t 时 刻 的 导数 。 


eo ee 包含 一 阶 导 数 ， 因 此 我 们 需要 对 前 面 的 微分 方程 做 如 下 
变形 : 

do{t) 

dt 





=v 


du(t) Oo. « 
= —~sin (t 
dt £ ae 


下 面 是 利用 odeint 计 算 单 摆 轨 迹 的 程序 : 





# -*- coding: utf-8 -*- 


from math import sin 
import numpy as np 
from scipy.integrate import odeint 


g= 9.8 
def pendulum_equations(w, t, 1): 
th, v=w 
dth =v 
dv = - g/l * sin(th) 


return dth, dv 
if _name__ == "__main_": 
import pylab as pl 
t = np.arange(0, 10, 0.01) 
track = odeint(pendulum_equations, (1.0, 0), t, args=(1.0, )) 
pl.plot(t, track[:, 0]) 
pl.title(u" 单 摆 的 角度 变化 ， 初始 角 度 =1 .90 弧度") 
pl.xlabel(u" 时 间 ( 秒 )") 
pl.ylabel(u" 震 度 角 度 ( 弧 度 )") 
pl. show() 


odeint 函 数 还 有 一 个 关键 字 参 数 args， 其 值 为 一 个 组 元 ， 这 些 值 都 会 作为 额外 的 参 
数 传递 给 func 画 数 。 程 序 使 用 这 之 种 方式 将 单 摆 的 长 度 传递 给 pendulum_equations 画 


o 


单 摆 的 角度 度 变化 ， 初 始 角度 =1.6 弧 度 
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初始 角度 为 1 弧度 的 单 摆 摆 动 角 度 和 时 间 的 关系 


计算 摆动 周期 
高 中 物理 译 介绍 过 当 最 大 摆动 角度 很 小 时 ， 单 摆 的 摆动 周期 可 以 使 用 如 下 公式 计 


f 
To = 274] 一 
g 


这 是 因为 当 8 << 1 时 ，sin8 ah, 这样 微 分 方程 就 变 成 了 : 
PA g 


KADARE- TA RSh, RADISH SAA. BEREA 
大 时 ， 上 述 的 近似 义理 会 带 来 无 法 忽视 的 误差 。 下 面 让 我 们 来 看 看 如 何 用 数值 计算 
的 方法 求 出 单 摆 在 任意 初始 摆 角 时 的 摆动 周期 。 


要 计算 摆动 周期 只 需要 计算 从 最 大 摆 角 到 0 摆 角 所 需 的 时 间 ， 摆 动 周 期 是 此 时 间 的 4 
ee 这 个 时 间 值 ， 首 先 需 要 定义 一 个 函数 pendulum_th 计 算 任意 时 刻 的 
A : 


def pendulum_th(t, 1, tho): 
track = odeint(pendulum_equations, (th0, 0), [0, t], args=(1,). 
return track[-1, 0] 


pendulum_th 函 数 计算 长 度 为 | 初始 角度 为 th0 的 单 摆 在 时 刻 t 的 摆 角 。 此 函数 仍然 使 
用 odeint 进 行 微分 方程 组 求解 ， 只 是 我 们 只 需要 计算 时 刻 t 的 摆 角 ， 因 此 传递 给 
odeint 的 时 间 序 列 为 [0, t] odeint 内 部 会 对 时 间 进 行 细 分 ， 保 证 最 终 的 解 是 正确 


N 
o 


接 下 来 只 需要 找到 第 一 个 时 pendulum_th 的 结果 为 0 的 时 间 即 可 。 这 相当 于 对 
pendulum_th 函 数 求解 ， 可 以 使 用 scipy.optimize.fsolve 函数 对 这 种 非 线 性 方程 进 
行 求解 。 





def pendulum period(1, th0): 
tO = 2*np.pi*sqrt( 1/g ) / 4 
t = fsolve( pendulum_th, tO, args = (l, thO) ) 
return t*4 


和 odeint 一 样 ， 我 们 通过 fsolve 的 args 关 键 字 参数 将 额外 的 参数 传递 给 pendulum_th 
画 数 。fsolve 求 解 时 需要 一 个 初始 值 尽量 接近 真实 的 解 ， 用 小 角度 单 摆 的 周期 的 1/4 
作为 这 个 初始 值 是 一 个 很 不 错 的 选择 。 下 面 利 用 pendulum_period 函 数 计算 出 初始 
摆动 角度 从 0 到 90 度 的 摆动 周期 : 


ths = np.arange(0, np.pi/2.0, 0.01) 
periods = [pendulum_period(1, th) for th in ths] 


为 了 验证 fsolve 求 解 摆动 周期 的 正确 性 ， 我 从 维基 百科 中 找到 摆动 周期 的 精确 解 : 


其 中 的 函 a 完全 椭圆 积分 图 数 ， 其 定义 如 下 : 


o V1—Kksin?6 
我 们 可 以 用 scipy.special.ellipk 来 计算 此 函数 的 值 : 


periods2 = 4*sqrt(1.0/g)*ellipk(np.sin(ths/2)**2) 


下 图 比较 两 种 计算 方法 ， 我 们 看 到 其 结果 是 完全 一 致 的 : 
长 度 为 1 米 单 探 : 初始 摆 角 -摆动 周期 





2.0@ Ti 
$.0 8.2 8.4 8.6 8.8 1.0 1.2 1.4 1.6 


初始 摆 角 (弧度 ) 


单 摆 的 摆动 周期 和 初始 角度 的 关系 
完整 的 程序 请 参见 : 单 摆 摆动 周期 的 计算 


双 摆 模拟 


接 下 来 让 我 们 来 看 看 如 何 对 双 摆 系统 进行 模拟 。 双 摆 系 统 的 如 下 图 所 示 ， 





两 根 长 度 为 L1 和 L2 的 无 质量 的 细 棒 的 顶端 有 质量 分 别 为 m1 和 m2 的 两 个 球 ， 初 始 角 
度 为 入 各， 要求 计算 从 此 初始 状态 释放 之 后 的 两 个 球 的 运动 轨迹 。 


公式 推导 
本 节 首先 介绍 如 何 利用 拉 格 朗 日 力学 获得 双 摆 系统 的 微分 方程 组 。 
拉 格 朗 日 力学 (摘自 维基 百科 ) 


拉 格 朗 日 力学 是 分 析 力 学 中 的 一 种 。 於 1788 年 由 拉 格 朗 日 所 创立 ， 拉 格 朗 日 力学 
是 对 经 典 力学 的 一 种 的 新 的 理论 表述 。 


经 典 力 学 最 初 的 表述 形式 由 牛顿 建立 ， 它 着 重 於 分 析 位 移 ， 速 度 ， 加 速度 ， 力 等 矢 
量 间 的 关系 ， 又 称 为 天 量力 学 。 拉 格 朗 日 引入 了 广义 坐标 的 概念 ， 又 运用 达 朗 贝尔 
原理 ， 求 得 与 牛顿 第 二 定律 等 价 的 拉 格 朗 日 方程 。 不 仅 如 此 ， 拉 格 朗 日 方程 具有 更 
普 静 的 意义 ， 适 用 范围 更 广泛 。 还 有 ， 选 取 恰 当 的 广义 坐标 ， 可 以 大 大 地 简化 拉 格 
朗 日 方程 的 求解 过 程 。 


假设 杆 L1 连 接 的 球体 的 坐标 为 X1 和 y1， 杆 L2 连 接 的 球体 的 坐标 为 X2 和 y2， 那 么 
Xx1,y1,x2,y2 和 两 个 角度 之 间 有 如 下 关系 : 


2 = Lysin(;) 

yı = —Lı cos(f1) 

E A E AA 
y2 = —Lı cos(@,) — Le cos(62) 
根据 拉 格 朗 日 量 的 公式 : 


£=T-V 

其 中 T 为 系统 的 动能 ，V 为 系统 的 势能 ， 可 以 得 到 如 下 公式 : 
mira. 2 m2,. f 

L= (i? +H) + (i +B) 一 migy — magyz 


其 中 正 号 的 项 目 为 两 个 小 球 的 动能 ， 符 号 的 项 目 为 两 个 小 球 的 势能 。 
将 前 面 的 坐标 和 角度 之 间 的 关系 公式 带 入 之 后 整理 可 得 : 


I[\mathcal{L} = \frac{m_1+m_2}{2} L_142 {\dot \theta_1}42 + \frac{m_2}{2} L_242 
{idot \theta_2}42 +m_2 L_1 L_2 {\dot \theta_1} {\dot \theta_2} \cos(\theta_1 - 
\theta_2) + 


(m_1+m_2)gL_1 \cos(\theta_1) + m_2gL_2 \cos(\theta_2)] 
(img/ddb810d6eed7 16ca3b15c0a3e9c94185accee394.png) 


对 于 变量 从 的 拉 格 朗 日 方程 : 
dec oO _, 


dt 6, OO — 

得 到 : 

Ly{(m, + mə) L1 6, + mzLz cos(b — 62)b2 + MeL sinfb 一 9) 62 + (mı + mg)gsin(@,)] = 0 
对 于 变量 o> 的 拉 格 朗 日 方程 : 


doc 2 _, 
dt 00, OO, 7 


到 : 
m2L» [L260 -一 Li cos( A; = Ay) 6, = Li sin( 4; = 9) 62 + gsin( )] = (0) 


这 一 计算 过 程 可 以 用 sympy 进 行 推导 : 








al 


# -*- coding: utf-8 -*- 
from sympy import * 
from sympy import Derivative as D 


var("x1 x2 y1 y2 11 12 mi m2 thi th2 dthi dth2 ddth1 ddth2 t g tmp' 


sublist = [ 

(D(th1(t), t, t), ddth1), 
(D(th1(t), t), dth1), 
(D(th2(t), t, t), ddth2), 
(D(th2(t),t), dth2), 
(th1i(t), th1), 

(th2(t), th2) 


] 

x1 = 11*sin(th1(t)) 

yi = -li*cos(thi(t)) 

x2 = li*sin(thi(t)) + 12*sin(th2(t)) 
y2 = -li*cos(thi(t)) - 12*cos(th2(t)) 
vx1 = diff(x1, t) 

vx2 = diff(x2, t) 

vy1 = diff(y1, t) 

vy2 = diff(y2, t) 

# 拉 格 朗 日 量 

L = m1/2*(vx1**2 + Vy1**2) + m2/2*(vx2**2 + vy2**2) = mi*g*y1 = m2’ 


# 拉 格 朗 日 方程 
def lagrange_equation(L, v): 

a L.subs(D(v(t), t), tmp).diff(tmp).subs(tmp, D(v(t), t)) 
L.subs(D(v(t), t), tmp).subs(v(t), v).diff(v).subs(v, v(t)? 
a.diff(t) - b 
c.subs(sublist) 
trigsimp(simplify(c) ) 
collect(c, [th1, th2,dth1,dth2,ddth1,ddth2]) 


b 
C 
C 
C 
C 
return c 


t+ Hl ott ot ott oo 


e 


eq1 
eq2 


lagrange_equation(L, th1) 
lagrange_equation(L, th2) 





执行 此 程序 之 后 ，eq1 对 应 于 内 的 拉 格 朗 日 方程 ， eq2 对 应 于 % 的 方程 。 


由 于 sympy 只 能 对 符号 变量 求 导 数 ， 即 只 能 计算 D(L, t), 而 不 能 计算 D(f, v(t))。 
此 在 求 偏 导 数 之 前 ， 将 偏 导 数 变量 置换 为 一 个 tmp 变 量 ， 然 后 对 tmp 变 量 求 导数 ， 例 
如 下 面 的 程序 行 对 D(v(t), t) 求 偏 导数 ， 即 计算 2C/2 


L.subs(D(v(t), t), tmp).diff(tmp).subs(tmp, D(v(t), t)) 


而 在 计算 ILo 时 ， 需 要 将 v(t) 蔡 换 为 v 之 后 再 进 TD it He 由 于 将 v(t) 替 换 为 v 的 
let, 2 D(v(t), t) 中 的 也 进行 蔡 换 ， 这 是 我 们 不 希望 的 结果 ， 因 此 先 将 D(v(t), t) 
替换 为 tmp， 微 分 计算 完毕 之 后 再 替换 回去 : 


L.subs(D(v(t), t), tmp).subs(v(t), v).diff(v).subs(v, v(t)).subs(tr 


«| = 








最 后 得 到 的 eq1, eq2 的 值 为 : 


>>> eqi 

ddth1*(m1*11**2 + m2*11**2) + 

ddth2*(11*12*m2*cos(th1)*cos(th2) + 11*12*m2*sin(th1)*sin(th2)) + 
dth2**2*(11*12*m2*cos(th2)*sin(th1) = 11*12*m2*cos(th1)*sin(th2)) - 
g*l1í*m1*sin(th1) + g*l1*m2*sin(th1) 

>>> eq2 

ddthi*(11*12*m2*cos(thi)*cos(th2) + 11*12*m2*sin(th1)*sin(th2)) + 
dthi**2*(11*12*m2*cos(th1)*sin(th2) - 11*12*m2*cos(th2)*sin(th1)) - 
g*12*m2*sin(th2) + ddth2*m2*12**2 


BE TT lll M ĖS 
结果 看 上 去 反复 杂 ， 其 实 只 要 运用 如 下 的 三 角 公 式 就 和 前 面 的 结果 一 致 了 : 


I[\sin \left(x+y\right)=\sin x \cos y + \cos x \sin y 





\cos \left(x+y\right)=\cos x \cos y - \sin x \sin y 
\sin \left(x-y\right)=\sin x \cos y - \cos x \sin y 


\cos \left(x-y\right)=\cos x \cos y + \sin x \sin y] 
(img/5149d766733feeccc7 1ce88a0b4d99749b762842.png) 


微分 方程 的 数值 解 

接 下 来 要 做 的 事情 就 是 对 如 下 的 微分 方程 求 数值 解 : 

(mı + 7712) 了 1 6, + 712L2 cos(4, 一 6505 + maLo sin(@, — A, )63 +(m, + m2)gsin(#,) = 0 
Lað, + Lı cos(6; — b2), 一 五 sin(b — 6)6? + gsin(62) = 0 

由 于 方程 中 包含 二 阶 导 数 ， 因 此 无 法 直接 使 用 odeint 孙 ar J 数值 求解 ， 我 们 很 容 
易 将 其 改写 为 4 个 一 阶 微 分 方程 组 ，4 个 未 知 变量 为 : 由, 内 ,uva ， 其 中 机 ,V2 为 
两 个 杆 转 动 的 角速度 。 

6, = v 


(my + mg) Liù, + MaLo cos(A; — ha Jù + MaLo sin(A, — 9) + (mı + mg)gsin(#,) = 0 


Lo Us + Li cos( A; = Ay ty = Li sin( 4, = A) 62 + g sin( 5) = (0) 


下 面 的 程序 利用 scipy.integrate.odeint 对 此 微分 方程 组 进行 数值 求解 : 


# -*- coding: utf-8 -*- 


from math import sin,cos 
import numpy as np 
from scipy.integrate import odeint 


g = 9.8 


class DoublePendulum(object): 
def _ init (self, m1, m2, 11, 12): 
self.mi, self.m2, self.11, self.12 = m1, m2, 11, 12 
self.init_status = np.array([0.0,0.0,0.0,0.0]) 


def equations(self, w, t): 
微分 方程 公式 
mi, m2, 11, 12 = self.m1, self.m2, self.11, self.12 
thi, th2, vi, v2 =w 


dthi = vi 

dth2 = v2 

#eq of thi 

a = 11*11*(mit+m2) # dvi parameter 

b = 11*m2*12*cos(thi-th2) # dv2 paramter 

c = 11*(m2*12*sin(thi-th2)*dth2*dth2 + (mi+m2)*g*sin(th1) ) 
#eq of th2 

d = m2*12*11*cos(thi-th2) # dvi parameter 

e = m2*12*12 # dv2 parameter 

f = m2*12*(-11*sin(th1-th2)*dthi*dthi + g*sin(th2)) 


dvi, dv2 = np.linalg.solve([[a,b],[d,e]], [-c,-f]) 
return np.array([dth1, dth2, dvi, dv2]) 


def double pendulum_odeint(pendulum, ts, te, tstep): 


对 双 摆 系统 的 微分 方程 组 进行 数值 求解 ， 返 回 两 个 小 球 的 X-Y 坐 标 


t = np.arange(ts, te, tstep) 


track = odeint(pendulum.equations, pendulum.init_status, t) 


thi_array, th2_array = track[:,0], track[:, 1] 
11, 12 = pendulum.11, pendulum.12 


x1 = 11*np.sin(thi_array) 
yi = -11*np.cos(th1_array) 
x2 = x1 + 12*np.sin(th2_array) 


y2 = y1 - 12*np.cos(th2_array) 


pendulum.init_status = track[-1,:].copy() #mahMKAm¢Apendul 


return [x1, y1, x2, y2] 


if name == "_ main_": 


import matplotlib.pyplot as pl 

pendulum = DoublePendulum(1.0, 2.0, 1.0, 2.0) 
th1，th2 = 1.0, 2.0 

pendulum.init_status[:2] = thi, th2 

x1, yi, x2, y2 = double_pendulum_odeint(pendulum, ©, 30, 0.02) 
pl.plot(x1,y1, label = u" ERR") 

pl.plot(x2,y2, label = u" FE") 
p1.title(u" 双 摆 系 统 的 轨迹 ， 初始 角度 =%s,%s" % (th1, th2)) 
pl.legend() 

pl.axis("equal") 

pl.show( ) 





程序 中 的 DoublePendulum.equations KURE CRRA R, HALBA 
w 数 组 中 的 变量 依次 为 : 


V1 
V2 


th1: 上 球 角度 
th2: 下 球 角 度 
: 上 球 角速度 
: 下 球 角速度 


返回 值 为 每 个 变量 的 导数 : 


dv 


dth1: 上 球 角速度 
dth2: 下 球 角速度 


1: 上 球 角 加 速度 


dv2: 下 球 角 加 速度 


其 中 dth1 和 dth2 很 容易 计算 ， 它 们 直接 等 于 传人 的 角速度 变量 : 


dthi 
dth2 


vi 
v2 


为 了 计算 dv1 和 dv2， 需 要 将 微分 方程 组 进行 变形 为 如 下 格式 : 
\dot v_1 =... 


\dot v_2 = ...](img/47827c6cd286f5e2e5d906f8e99385366e0db189.png) 


如 果 我 们 希望 让 程序 做 这 个 事情 的 话 ， 可 以 计算 出 dv1 和 dv2 的 系数 ， 然 后 调用 
linalg.solve 求解 线 型 方程 组 : 


#eq of tht 
= 11*11*(mi+m2) # dvi parameter 
b = 11*m2*12*cos(thi-th2) # dv2 paramter 


C 11*(m2*12*sin(th1-th2)*dth2*dth2 + (mi+m2)*g*sin(th1) ) 
#eq of th2 

d = m2*12*11*cos(thi-th2) # dvi parameter 

e = m2*12*12 # dv2 parameter 

f = m2*12*(-11*sin(th1-th2)*dthi*dthi + g*sin(th2)) 


dvi, dv2 = np.linalg.solve([[a,b],[d,e]], [-c,-f]) 


上 面 的 程序 相当 于 将 原始 的 微分 方程 组 变换 为 
l[a \dot v_1 + b\dotv_2+c=0 


d \dot v_1 + e \dotv_2 +f = 0] 
(img/Oadfbc1 2bbe1 ff9d4511bc29a532781e32e7609e.png) 


程序 绘制 的 小 球 运动 轨迹 如 下 : 


双 摆 系统 的 轨迹 ， 初 始 角度 =8.2,68.4 





初始 角度 微小 时 的 双 摆 的 摆动 轨迹 


双 摆 系统 的 轨迹 ， 初 始 角度 =1.6,2.6 





大 初始 角度 时 双 摆 的 摆动 轨迹 呈现 混沌 现象 
可 以 看 出 当初 始 角度 很 大 的 时 候 ， 摆 动 出 现 混 沌 现象 。 


z) Bl BAN 
计算 出 小 球 的 轨迹 之 后 我 们 很 容易 将 结果 可 视 化 ， 制 作成 动画 效果 。 制 作 动画 可 以 
有 多 种 选择 : 


e Visual 库 可 以 制作 3D 动 画 
e pygame 制 作 快 速 的 2D 动 画 
e tkinter 或 者 wxpython 直 接 在 界面 上 绘制 动画 


这 里 介绍 如 何 使 用 matplotlib 制 作 动画 。 整 个 动画 绘制 程序 如 下 : 


# -*- coding: utf-8 -*- 

import matplotlib 

matplotlib.use('WxXAgg') # do this before importing pylab 

import matplotlib.pyplot as pl 

from double _pendulum_odeint import double _pendulum_odeint, DoublePe 


fig = pl.figure(figsize=(4,4)) 
linei, = pl.plot([0,90], [0,0], "-o' 
line2, = pl.plot([0,9], [0,0], "-o 
pl.axis("equal") 

pl.xlim(-4,4) 

pl.ylim(-4,2) 


pendulum = DoublePendulum(1.0, 2.0, ; 
pendulum.init_status[:] = 1.0, 2.0, 0, 0 


x1, y1, x2, y2 = [],[];[],[] 
idx = 0 


def update_line(event): 
global x1, x2, y1, y2, idx 
if idx == len(x1): 
x1, yi, x2, y2 = double_pendulum_odeint(pendulum, 0, 1, 0.( 
idx = 0 
linei.set_xdata([0, x1[idx]]) 
linei.set_ydata([0, y1[idx]]) 
line2.set_xdata([xi[idx], x2[idx]]) 
line2.set_ydata([y1i[idx], y2[idx]]) 
fig.canvas.draw() 
idx += 1 


import wx 

id = wx.NewId() 

actor = fig.canvas.manager.frame 
timer = wx.Timer(actor, id=id) 

timer .Start(1) 

wx.EVT_TIMER(actor, id, update_line) 
pl.show( ) 


SS 
程序 中 强制 使 用 WXAgg 进 行 后 台 绘 制 : 





matplotlib.use('WXAgg') 


然后 启动 WX 库 中 的 时 间 事 件 调用 update_line 函 数 重新 设置 两 条 直线 的 端点 位 置 : 


import wx 

id = wx.NewId() 

actor = fig.canvas.manager.frame 
timer = wx.Timer(actor, id=id) 

timer .Start(1) 

wx.EVT_TIMER(actor, id, update_line) 


在 update_line 函 数 中 ， 每 次 轨迹 数组 播放 完毕 之 后 ， 就 调用 : 


if idx == len(x1): 
x1, yi, x2, y2 = double_pendulum_odeint(pendulum, 0, 1, 0.05) 
idx = 0 
EJ 
重新 生成 下 一 秒 钟 的 轨迹 。 由 于 在 double_pendulum_odeint HAHA $odeinti+ 


算 的 最 终 的 状态 赋 给 pendulum.init_status ， 因 此 连续 调用 
double_pendulum_odeint 函数 可 以 生成 连续 的 运动 轨迹 


def double_pendulum_odeint(pendulum, ts, te, tstep): 
track = odeint(pendulum.equations, pendulum.init_status, t) 


pendulum.init_status = track[-1,:].copy() 
return [x1, y1, x2, y2] 


程序 的 动画 效果 如 下 图 所 示 : 
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双 摆 的 摆动 动 男 效 果 截 图 


分 形 与 混 ; 
自然 界 的 很 多 事物 ， 例 如 树木 、 云 彩 、 山 脉 、 闪 电 、 雪 花 以 及 海岸 线 等 等 都 呈现 出 
传统 的 几何 学 不 能 描述 的 形状 。 这 些 形状 都 有 如 下 的 特性 : 


。 有 着 十 分 精细 的 不 规则 的 结构 
。 整体 与 局 部 相似 ， 例 如 一 根 树 权 的 形状 和 一 棵 树 很 像 


分 形 几何 学 就 是 用 来 研究 这 样 一 类 的 几何 形状 的 科学 ， 借 助 计算 机 的 高 速 计算 和 图 
像 显示 ， 使 得 我 们 可 以 更 加 深入 地 直观 地 观察 分 形 几 何 。 在 本 章 中 ， 让 我 们 用 
Python 绘制 一 些 经 典 的 分 形 图 案 。 


Mandelbrot € 


Mandelbrot( 曼 德 布 洛 特 ) 集 合 是 在 复 平 面 上 组 成 分 形 的 点 的 集合 
Mandelbrot 集 合 的 定义 (摘自 维基 百科 ) 
Mandelbrot 集 合 可 以 用 下 面 的 复 二 次 多 项 式 定义 : 


fd) = +c 

其 中 c 是 一 个 复 参 数 。 对 于 每 一 个 cs， 从 z=0 开 始 对 函数 大 (>) 进行 迭代 。 
序列 (0, fe(0), fel Fe(0)), fe(fe(fe(0))),…) 的 值 或 者 延伸 到 无 限 大 ， 或 者 只 停留 在 有 
限 半径 的 圆 盘 内 。 


Mandelbrot 集 合 就 是 使 以 上 序列 不 发 散 的 所 有 c 点 的 集合 。 


从 数学 上 来 讲 ，Mandelbrot 集 合 是 一 个 复数 的 集合 。 一 个 给 定 的 复数 c 或 者 属于 
Mandelbrot 集 合 ， 或 者 不 是 。 


用 程序 绘制 Mandelbrot 集 合 时 不 能 进行 无 限 次 迭代 ， 最 简单 的 方法 是 使 用 逃逸 时 间 
(迭代 次 数 ) 进 行 绘制 ， 具 体 算法 如 下 : 


判断 每 次 调用 画 数 大 (2) 得 到 的 结果 是 否 在 半径 R 之 内 ， 即 复数 的 模 小 于 R 
记录 下 模 大 于 R 时 的 迭代 次 数 

迭代 最 多 进行 N 次 

不 同 的 迭代 次 数 的 点 使 用 不 同 的 颜色 绘制 


下 面 是 完整 的 绘制 Mandelbrot 集 合 的 程序 : 


# -*- coding: utf-8 -*- 


import numpy as np 

import pylab as pl 

import time 

from matplotlib import cm 


def iter_point(c): 
Z=C 
for i in xrange(1, 100): # 最 多 迭代 100 次 
if abs(z)>2: break # 半径 大 于 2 则 认为 逃逸 
Z = Z*Z+C 


return i # 返回 迭代 次 数 


def draw_mandelbrot(cx, cy, d): 


绘制 点 (cx，cy ) 附 近 正 负 d 的 范围 的 Mandelbrot 
x0, x1, yO, y1 = cx-d, cx+d, cy-d, cytd 
y, X = np.ogrid[y0:y1:200j, x0:x1:200] | 
c = xX + y*1j 
start = time.clock() 
mandelbrot = np.frompyfunc(iter_point,1,1)(c).astype(np.float) 
print "time=",time.clock() - start 
pl.imshow(mandelbrot, cmap=cm.Blues_r, extent=[x0,x1,y0,y1]) 
pl.gca().set_axis_off() 


x,y = 0.27322626, 0.595153338 


pl.subplot(231) 
draw_mandelbrot(-0.5,0,1.5) 
for i in range(2,7): 

pl.subplot(230+i) 

draw_mandelbrot(x, y, 0.2**(i-1)) 
pl.subplots_adjust(0.02, ©, 0.98, 1, 0.02, 0) 
pl.show() 


二 “g 
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Mandelbrot 集 合 ， 以 5 倍 的 倍率 放大 点 (0.273, 0.595) 附 近 

程序 中 的 iter_point 函 数 计算 点 c 的 逃逸 时 间 ， 逃 逸 半 径 R 为 2.0， 最 大 迭 代 次 数 为 
100。draw_mandelbrot 函 数 绘制 以 点 (cx, cy) 为 中 心 ， 边 长 为 2*d 的 正方 形 区 域内 的 
Mandelbrot 集 合 。 

下 面 3 行 计算 指定 范围 内 的 迭代 公式 的 参数 c，c 是 一 个 元 素 为 复数 的 二 维 数 组 ， 大 
小 为 200*200， 注 意 np.ogrid 不 是 画 数 : 


xO, x1, yO, y1 = cx-d, cx+d, cy-d, cy+d 
y, x = np.ogrid[y0:y1:200j, x0:x1:200] | 
C= x + y*1j 


下 面 一 行程 序 通 过 调用 np.frompyfunc 将 iter_point 转 换 为 NumPy 的 ufunc 男 数 ， 这 样 
它 可 以 自动 对 c 中 的 每 个 元 素 调 用 iter_point 函 数 ， 由 于 结果 的 数组 元 素 类 型 为 
object， 还 需要 调用 astype 方 法 将 其 元 素 类 型 转换 为 浮 点 类 型 : 


mandelbrot = np.frompyfunc(iter_point,1,1)(c).astype(np.float) 


最 后 调用 matplotlib 的 imshow 画 数 将 结果 数组 绘制 成 图 ， 通 过 cmap 关 键 字 参数 指定 
图 的 值 和 颜色 的 映射 表 : 


pl.imshow(mandelbrot, cmap=cm.Blues_r, extent=[x0, x1, yO, y1]) 
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使 用 Python 绘制 Mandelbrot 集 合 最 大 的 问题 就 是 运算 速度 太 慢 ， 下 面 是 上 面 每 幅 图 
的 计算 时 间 : 


time= 0.88162629608 
time= 1.53712748408 
time= 1.71502160191 
time= 1.8691174437 

time= 3.03812691278 


因为 计算 每 个 点 的 逃逸 时 间 均 不 相同 ， 因 此 每 幅 图 的 计算 时 间 也 不 相同 。 


计算 速度 慢 的 最 大 的 原因 是 因为 iter_point 函 数 的 运算 速度 慢 ， 如 果 将 此 函数 用 C 话 
言 重 写 的 话 将 能 显著 地 提高 计算 速度 ， 下 面 使 用 scipy.weave 库 将 C++ 重 写 的 
iter_point 函 数 转换 为 Python 能 调用 的 函数 : 


import scipy.weave as weave 


def weave_iter_point(c): 
code = "nN 
std: :complex<double> z; 
int i; 
z= C; 
for(i=1;1<100; i++) 


{ 

if(std::abs(z) > 2) break; 
Z = z*z+c; 

} 


return_val=i; 


f = weave.inline(code, ["c"], compiler="gcc") 
return f 


下 面 是 使 用 weave_iter_point 函 数 计算 Mandelbrot 集 合 的 时 间 : 


time= 0.285266982256 
time= 0.271430028118 
time= 0.293769180161 
time= 0.308515188383 
time= 0.411168179196 


通过 NumPy 的 数组 运算 也 可 以 提高 计算 速度 ， 前 面 的 计算 都 是 先 对 复数 平面 上 的 每 
个 点 进行 循环 ， 然 后 再 循环 迭代 计算 每 个 点 的 逃逸 时 间 。 如 果 要 用 NumPy 的 数组 运 
算 加 速 计算 的 话 ， 可 以 将 这 两 个 循环 的 顺序 颠倒 过 来 ， 下 面 的 程序 演示 这 一 算法 : 


# -*- coding: utf-8 -*- 


import numpy as np 

import pylab as pl 

import time 

from matplotlib import cm 


def draw_mandelbrot(cx, cy, d, N=200): 


绘制 点 (cx，cy ) 附 近 正 负 d 的 范围 的 Mandelbrot 


global mandelbrot 


x0, x1, yO, yi = cx-d, cx+d, cy-d, cy+d 
y, X = np.ogrid[y0:y1:N*1j, x0:x1:N*1j] 
c = x + y*1] 


# 创建 X,Y 轴 的 坐标 数组 
ix, iy = np.mgrid[0:N,0:N] 


# 创建 保存 mandelbrot 图 的 二 维 数组 ， 缺 省 值 为 最 大 迭代 次 数 
mandelbrot = np.ones(c.shape, dtype=np.int)*100 


# 将 数组 都 变 成 一 维 的 


ix.shape = -1 
iy.shape = -1 
c.shape = -1 


z = c.copy() # McFRAIKt, ALARA RA AL 
start = time.clock() 


for i in xrange(1,100): 
# 进行 一 次 迭代 
z *= Zz 
Z += C 
# 找到 所 有 结果 逃逸 了 的 点 
tmp = np.abs(z) > 2.0 
# 将 这 些 逃 逸 点 的 迭代 次 数 赋值 给 mandeLbrot 图 
mandelbrot[ix[tmp], iy[tmp]] = i 


# 找到 所 有 没有 逃逸 的 点 

np.logical_not(tmp, tmp) 

# 更 新 ix，iy，c，Zz 只 包含 没有 逃逸 的 点 

ix,iy,c,z = ix[tmp], iy[tmp], c[tmp],z[tmp] 
if len(z) == 0: break 


print "time=",time.clock() - start 
pl.imshow(mandelbrot, cmap=cm.Blues_r, extent=[x0, x1, yO, y1]) 
pl.gca().set_axis_off() 


X,Y = 0.27322626, 0.595153338 
pl.subplot (231) 


draw_mandelbrot(-0.5,0,1.5) 
for i in range(2,7): 


pl.subplot(230+71) 

draw_mandelbrot(x, y, 0.2**(i-1)) 
pl.subplots_adjust(0.02, 0, 0.98, 1, 0.02, 0) 
pl.show( ) 


为 了 减少 计算 次 数 ， 程 序 中 每 次 迭代 之 后 ， 都 将 已 经 逃逸 的 点 剔除 出 去 ， 这 样 就 需 
要 保存 每 个 点 的 下 标 ， 程 序 中 用 jx 和 iy 这 两 个 数组 来 保存 没有 逃逸 的 点 的 下 标 ， 
为 有 人 额外 的 数组 保存 下 标 ， 因 此 数组 z 和 c 不 需要 是 二 维 的 。 画 数 和 迭代 部 分 的 程序 如 
F: 


# 进行 一 次 迭代 
A Wet Z 
Z += C 


使 用 *=, += 这 样 的 运算 符 能 够 让 NumPy 不 分 配额 外 的 空间 直接 在 数组 Z 上 进行 运 
算 。 


下 面 的 程序 计算 出 逃逸 点 ，tmp 是 逃逸 点 在 z 中 的 下 标 ， 由 于 z 和 ix 和 iy 等 数组 始终 是 
同时 更 新 的 ， 因 此 ix[tmp], iy[tmp] 就 是 逃逸 点 在 图 像 中 的 下 标 : 


# 找到 所 有 结果 逃逸 了 的 点 

tmp = np.abs(z) > 2.0 

# pik LEVER AVIATOR Ba a Amandelbrot A 
mandelbrot[ix[tmp], iy[tmp]] = i 


最 后 通过 对 tmp 中 的 每 个 元 素 取 逻辑 反 ， 更 新 所 有 没有 逃逸 的 点 的 对 应 的 ix, iy, C, 


# 找到 所 有 没有 逃逸 的 点 

np.logical_not(tmp, tmp) 

# 更 新 ix，iy，c，Zz 只 包含 没有 逃逸 的 点 

ix,iy,c,z = ix[tmp], iy[tmp], c[tmp], z[tmp] 


此 程序 的 计算 时 间 如 下 : 


time= 0.186070576008 
time= 0.327006365334 
time= 0.372756034636 
time= 0.410074464771 
time= 0.681048289658 
time= 0.878626752841 


连续 的 逃逸 时 间 
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修改 逃逸 半径 R 和 最 大 迭代 次 数 N， 可 以 绘制 出 不 同 效果 的 Mandelbrot 集 合 图 案 。 


但 是 前 面 所 述 的 方法 计算 出 的 逃逸 时 间 是 大 于 逃逸 半径 时 的 迭代 次 数 ， 因 此 所 输出 


的 图 像 最 多 只 有 N 种 不 同 的 颜色 值 ， 有 很 强 的 梯度 感 。 


渐变 处 理 ， 使 用 下 面 的 公式 进行 逃逸 时 间 计 算 : 
n — logs loge |n| 


n 是 迭代 n 次 之 后 的 结果 ， 通 过 在 逃逸 时 间 的 计算 中 引入 迭代 结果 的 模 值 ， 结 果 将 
不 再 是 整数 ， 而 是 平滑 渐变 的 。 


下 面 是 计算 此 逃逸 时 间 的 程序 : 


def smooth_iter_point(c): 


Z = C 
for i in xrange(1, iter_num): 
if abs(z)>escape_radius: break 
Z = Z*Z+C 
absz = abs(z) 
if absz > 2.0: 
mu = i - log(log(abs(z),2),2) 
else: 
mu = i 
return mu # 返回 正规 化 的 迭代 次 数 


为 了 在 不 同 的 梯度 之 间 进行 


如 果 你 的 逃逸 半径 设置 得 很 小 ， 例 如 2.0， 那 么 有 可 能 结果 不 够 平滑 ， 这 时 可 以 在 迫 
代 循 环 之 后 添加 几 次 迭代 保证 z 能 够 足够 逃逸 ， 例 如 : 


Z 
Z 
i 


下 图 是 逃逸 半径 为 10， 最 大 迭代 次 数 为 20 时 ， 绘 制 的 结果 : 
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逸 半径 =10， 最 大 迭代 次 数 =20 的 平滑 义理 后 的 Mandelbrot 集 合 
逃逸 时 间 公式 是 如 何 得 出 的 ? 

参考 : http://linas.org/art-gallery/escape/ray.html 
完整 的 程序 请 参考 绘制 Mandelbroi 集 合 


IE UE EN 2% (IFS) 


AEM RAS MARZO ARH, CMA ENNEA K a Ea BA 
(EY, FEARN Bea it 24 il) — PR A BAM FRAN RRA : 


有 下 面 4 个 线性 函数 将 二 维 平面 上 的 坐标 进行 线性 映射 变换 : 


ane 

x(n+1) = 0 

y(n+1) = 0.16 * y(n) 
De 

x(n+1) = 0.2 * x(n) = 0.26 * y(n) 

y(n+1) = 0.23 * x(n) + 0.22 * y(n) + 1.6 
Sie 

x(n+1) = -0.15 * x(n) + 0.28 * y(n) 

y(n+1) = 0.26 * x(n) + 0.24 * y(n) + 0.44 
4. 

x(n+1) = 0.85 * x(n) + 0.04 * y(n) 

y(n+1) = -0.04 * x(n) + 0.85 * y(n) + 1.6 


所 谓 迭 代 函 数 是 指 将 函数 的 输出 再 次 当 作 输 入 进行 迭代 计算 ， 因 此 上 面 公 式 都 是 通 
过 坐标 x(n),y(n) 计算 变换 后 的 坐标 x(n+1),y(n+1)。 现 在 的 问题 是 有 4 个 迭代 函数 ， 
迭代 时 选择 哪个 函数 进行 计算 呢 ?我们 为 每 个 函数 指定 一 个 概率 值 ， 它 们 依次 为 

1%, 7%, 7% 和 85%。 选 择 迭 代 画 数 时 使 用 通过 每 个 画 数 的 概率 随机 选择 一 个 画 数 
进行 迭代 。 上 面 的 例子 中 ， 第 四 个 画 数 被 选择 迭代 的 概率 最 高 。 


后 我 们 从 坐标 原点 (0,0) 开 始 迭 代 ， eee 就 得 到 了 
叶子 的 分 形 图 案 。 下 面 的 程序 演示 这 一 计算 过 程 : 


# -*- coding: utf-8 -*- 

import numpy as np 

import matplotlib.pyplot as pl 
import time 


H 蕨 类 植物 叶子 的 迭代 函数 和 其 概率 值 
eqi = np.array([[0,9,0],[0,9.16,0]]) 
p1 = 0.01 


eq2 = np.array([[0.2, -0.26,0],[0.23,0.22,1.6]]) 
p2 = 0.07 


eq3 = np.array([[-0.15, 0.28, 0],[0.26,0.24,0.44]]) 
p3 = 0.07 


eq4 = np.array([[0.85, 0.04, 0],[-0.04, 0.85, 1.6]]) 
p4 = 0.85 


def ifs(p, eq, init, n): 
PETHIBGS 

p: 每 个 函数 的 选择 概率 列表 
eq: JAR BRINR 

init: RIA 

n: JERR 


返回 值 : 每 次 迭代 所 得 的 X 坐 标 数组 ， Y 坐 标 数组 ， 计算 所 用 的 函数 下 标 


# 和 迭代 向 量 的 初始 化 
pos = np.ones(3, dtype=np.float) 
pos[:2] = init 


# ( , i+ BAA eS 

p = np.add.accumulate(p) 

rands = np.random.rand(n) 

select = np.ones(n, dtype=np.int)*(n-1) 

for i, X in enumerate(p[::-1]): 
select[rands<x] = len(p)-i-1 


# 结果 的 初始 化 
result = np.zeros((n,2), dtype=np. float) 
c = np.zeros(n, dtype=np. float) 


for i in xrange(n): 
eqidx = select[i] # 所 选 的 函数 下 标 
tmp = np.dot(eq[eqidx], pos) # 进行 迭代 
pos[:2] = tmp # 更 新 迭代 向 量 


# 保存 结 
result[i] = tmp 
c[i] = eqidx 


return result[:,0], result[:, 1], c 


start = time.clock() 

x, yY, © = ifs([p1,p2,p3,p4], [eq1, eq2,eq3,eq4], [0,0], 100000) 
print time.clock() - start 

pl.figure(figsize=(6,6)) 

pl.subplot(121) 

pl.scatter(x, y, s=1, c="g", marker="s", linewidths=0) 
pl.axis("equal") 


pl.axis("off") 

pl.subplot(122) 

pl.scatter(x, y, s=1,c = c, marker="s", linewidths=0) 
pl.axis("equal") 

pl.axis("off") 
pl.subplots_adjust(left=0, right=1, bottom=0, top=1,wspace=0, hspace=0' 
pl.gcf().patch.set_facecolor("white" ) 

pl.show( ) 


‘| 











Fee PEISA EAT RA ERER, Bei ERA AA 
(numpy.dot) 的 输出 ， Ie e E : 


pos = np.ones(3, dtype=np.float) 
pos[:2] = init 


RES RADAR ARATE eee ANEMA T : x(n), y(n), 1.0 


为 了 减少 计算 时 间 ， 我 们 不 在 迭代 循环 中 计算 随机 数 选 择 迭 代 方 程 ， 而 是 事先 通过 
每 个 函数 的 概率 ， 计 算出 画 数 选择 数组 select， Sere Ee eee 
概率 累加 ， 然 后 产生 一 组 0 到 1 之 间 的 随机 数 ， 通 过 判断 随机 数 所 在 的 概率 区 间 选 

不 同 的 方程 下 标 : 


p = np.add.accumulate(p) 

rands = np.random.rand(n) 

select = np.ones(n, dtype=np.int)*(n-1) 

for i, X in enumerate(p[::-1]): 
select[rands<x] = len(p)-i-1 


Bx la $4 118 it 39 scatters A NRCS ATS EUG ep eT I Ah: 


pl.scatter(x, y, s=1, c="g", marker="s", linewidths=0) 


其 中 每 个 关键 字 参 数 的 含义 如 下 : 


。 s: 散 列 点 的 大 小 ， 因 为 我 们 要 绘制 10 万 点 ， 因 此 大 小 选择 为 1 
e c: 点 的 颜色 ， 这 里 选择 绿色 

e marker : 点 的 形状 ， “eae 方形 的 绘制 是 最 快 的 

e linewidths : 点 的 边框 宽度 ，0 表 示 没 有 边框 


此 外 ， 关 键 字 参数 c 还 可 以 传 入 一 个 数组 ， 作 为 每 个 点 的 颜色 值 ， 我 们 将 计算 坐标 
的 汞 数 下 标 传人 入， 这 样 可 以 直观 地 看 出 哪个 点 是 哪个 事 数 迭代 产生 的 : 


pl.scatter(x, y, s=1,c = c, marker="s", linewidths=0) 


下 图 是 程序 的 输出 : 





图 数 迭 代 系 统 所 绘制 的 蕨 类 植物 的 叶子 


观察 右 图 的 4 种 颜色 的 部 分 可 以 发 现 概率 为 1% 的 函数 1 所 计算 的 是 叶 杆 部 分 (深蓝 
色 )， 概 率 为 7% 的 两 个 画 数 计 算 的 是 左右 两 片子 叶 ， 而 概率 为 85% 的 范 数 计 算 的 是 
整个 叶子 的 迭代 : 即 最 下 面 的 三 种 颜色 的 点 通过 此 函数 的 迭代 产生 上 面 的 所 有 的 深 
红色 的 点 。 


我 们 可 以 看 出 整个 叶子 呈现 出 完美 的 自 相 似 特性 ， 任 意 取 其 中 的 一 个 子叶 ， 将 其 旋 
转 放 大 之 后 都 和 整个 叶子 相同 。 


2D 仿 射 变换 
上 面 所 介绍 的 4 个 变换 方程 的 一 般 形式 如 下 : 


x(n+1) 
y(n+1) 


A* x(n) EBE y(n) EC 
D* x(n) EL * y(n) tF 


这 种 变换 被 称 为 2D 仿 射 变换 ， 它 是 从 2D 坐 标 到 其 他 2D 华 标的 线性 映射 ， 保 留 直线 
性 和 平行 性 。 即 原来 是 直线 上 的 坐标 ， 变 换 之 后 仍然 成 一 条 直线 ， 原 来 是 平行 的 直 
线 ， 变 换 之 后 仍然 是 平行 的 。 这 种 变换 我 们 可 以 看 作 是 一 系列 平移 、 缩 放 、 翻 转 和 
旋转 变换 构成 的 。 


为 了 直观 地 显示 仿 射 变换 ， 我 们 可 以 使 用 平面 上 的 两 个 三 角形 来 表示 。 因 为 仿 射 变 
换 公 式 中 有 6 个 未 知 数 : A, B, C, D,E, F， 而 每 两 个 点 之 间 的 变换 决定 两 个 方程 ， 
此 一 共 需 要 3 组 点 来 决定 六 个 变换 方程 ， 正 好 是 两 个 三 角形 ， 如 下 图 所 示 : 





两 个 三 角形 决定 一 个 2D 仿 射 变换 的 六 个 参数 


从 红色 三 角形 的 每 个 顶点 变换 到 绿色 三 角形 的 对 应 顶点 ， 正 好 能 够 决定 仿 射 变换 中 
的 六 个 参数 。 这 样 我 们 可 是 使 用 N+1 个 三 角形 ， 决 定 N 个 仿 射 变换 ， 其 中 的 每 一 个 
变换 的 参数 都 是 由 第 0 个 三 角形 和 其 它 的 三 角形 决定 的 。 这 第 0 个 三 角形 我 们 称 之 为 
基础 三 角形 ， 其 余 的 三 角形 称 之 为 变换 三 角形 。 


为 了 绘制 迭代 事 数 系统 的 图 像 ， 我 们 还 需要 给 每 个 仿 射 变换 方程 指定 一 个 迭代 概率 
的 参数 。 此 参数 也 可 以 使 用 三 角形 直观 地 表达 出 来 : 迭代 概率 和 变换 三 角形 的 面积 
成 正比 。 即 迭代 概率 为 变换 三 角形 的 面积 除 以 所 有 变换 三 角形 的 面积 之 和 。 


如 下 图 所 示 ， 前 面 介 绍 的 蕨 类 植物 的 分 形 图 案 的 迭代 方程 可 以 由 5 个 三 角形 决定 ， 
可 以 很 直观 地 看 出 柴 色 的 小 三 角形 决定 了 叶子 的 茎 ; 而 两 个 蓝 色 的 三 角形 决定 了 左 
右 两 片子 叶 ; 绿色 的 三 角形 将 莽 和 两 片子 叶 往 上 复制 ， 形 成 整 片 叶 子 。 





| 


5 个 三 角形 的 仿 射 方程 绘制 蕨 类 植物 的 叶子 


迭代 回 数 系统 设计 器 
按照 上 节 所 介绍 的 三 角形 法 ， 我 们 可 以 设计 一 个 迭代 男 数 系统 的 设计 工具 ， 如 下 图 
所 示 : 


eee reel mente Rg eee ene 
部 分 : 

首先 通过 两 个 三 角形 求解 仿 射 方程 的 系数 相当 于 求 六 元 线性 方程 组 的 解 ，solve_eq 
函数 完成 这 一 工作 ， 它 先 计算 出 线性 方程 组 的 矩阵 a 和 b, 然后 调用 NumPy 的 
linalg.solve 对 线性 方程 组 a*X = b 求解 : 


def solve_eq(triangle1, triangle2): 
解 方 程 ， 从 triang1le1 变 换 到 triangle2 的 变换 系数 
triangle1, 2 是 二 维 数组 : 


x0, yO 

x1,y1 

X2,Yy2 
x0, yO = triangle1[0] 
x1,y1 = triangle1[1] 
x2,y2 = triangle1[2] 
a = np.zeros((6,6), dtype=np.float ) 
b = triangle2.reshape(-1) 
a[0, 0:3] = x0,y0,1 
a[1, 3:6] = x0,y0,1 
a[2, 0:3] = x1,y1,1 
a[3, 3:6] = x1,y1,1 
a[4, 0:3] = x2,y2,1 
a[5, 3:6] = x2,y2,1 


c = np.linalg.solve(a, b) 
c.shape = (2,3) 
return c 


triangle_area iš t A TAERE, vE ANumPyhcrossžn+ B= AIHA 
个 边 的 向 量 的 叉 积 


def triangle_area(triangle): 


计算 三 角形 的 面积 

triangle[0] 

triangle[1] 

triangle[2] 

AB A-B 

AC = A-C 

return np.abs(np.cross(AB, AC) )/2.0 


A 
B 


C 


整个 程序 的 界面 使 用 TraitsUl 库 生成 ， 将 matplotlib 的 Figure 控 件 通过 
MPLFigureEditor 和 MPLFigureEaitor 类 族人 到 Tra 必 Ul/ 生 成 的 界面 中 ， 请 参考 : GE 
计 自 己 的 Trait 编 辑 器 _](traitsui manual_custom_editorhtml) 


IFSDesigner_ figure_default 创 建 Figure 对 象 ， 并 且 添 加 两 个 并 排 的 子 图 ax 和 ax2， 
ax 用 于 三 角形 编辑 ， 而 ax2 用 于 分 形 图 案 显 示 。 


def _figure_default(self): 


figure 属 性 的 缺 省 值 ， 直 接 创建 一 个 Figure 对 象 
figure = Figure() 
self.ax = figure.add_subplot(121) 
self.ax2 = figure.add_subplot(122) 
self.ax2.set_axis_off() 
self .ax.set_axis_off() 
figure.subplots_adjust(left=0, right=1, bottom=0, top=1,wspace=0, | 
figure.patch.set_facecolor("w") 
return figure 





IFSTriangles 类 完成 三 角形 的 编辑 工作 ， 其 中 通过 如 下 的 语句 绑 定 Figure 控 件 的 
canvas 的 鼠标 事件 


Canvas = ax.figure.canvas 

# 绑 定 canvas 的 鼠标 事件 

Ccanvas.mpl_connect('button_press_event', self.button_press_callbacl 
canvas.mpl_connect('button_release_event', self.button_release_cal- 
canvas.mpl_connect('motion_notify_event', self.motion_notify_callbé 


-| 


由 于 canvas 只 有 在 真正 显示 Figure 时 才 会 创建 ， 因 此 不 能 在 创建 Figure 控 件 时 创建 
IFSTriangles 对 象 ， 而 需要 在 界面 生成 之 后 ， 显 示 之 前 创建 它 。 这 里 我 们 通过 给 
IFSDesigner 类 的 view 属 性 指定 其 handler 为 IFSHandler 对 象 ， 重 载 Handler 的 init 方 
法 ， 此 方法 在 界面 生成 之 后 ， 显 示 之 前 被 调用 : 





class IFSHandler (Handler): 


在 界面 显示 之 前 需要 初始 化 的 内 容 
def init(self, info): 
info.object.init_gui_component() 
return True 


然后 IFSDesigner 类 的 init _ gui _ component 方 法 完成 实际 和 canvas 相 关 的 初始 工作 : 


def init_gui_component(self): 
self.ifs_triangle = IFSTriangles(self.ax) 
self .figure.canvas.draw() 
thread.start_new_thread( self.ifs_calculate, ()) 


由 于 通过 函数 迭代 计算 分 形 图 案 比 较 费 时 ， 因 此 在 另外 一 个 线程 中 执行 
ifs_calculate 方 法 进行 运算 ， 每 计算 ITER_COUNT 个 点 ， 就 调用 ax2.scatter 将 产生 
的 点 添加 进 ax2 中 ， 由 于 随 着 ax2 中 的 点 数 增加 ， 界 面 重 绘 将 越 来 越 慢 ， 因 此 在 
draw_points 画 数 中 限制 最 多 只 调用 ITER_TIMES 次 scatter 画 数 。 因 为 在 别 的 线程 中 
不 能 更 新 界面 ， 因 此 通过 调用 wx.CallAfter 在 管理 GUI 的 线程 中 调用 draw_points 进 
行 界面 刷新 。: 


def ifs_calculate(self): 


在 别 的 线程 中 计算 
def draw_points(x, y, Cc): 
if len(self.ax2.collections) < ITER_TIMES: 

try: 
self.ax2.scatter(x, y, s=1, c=c, marker="s", linew: 
self .ax2.set_axis_off() 
self .ax2.axis("equal") 
self .figure.canvas.draw() 

except: 
pass 


def clear_points(): 
self .ax2.clear() 


while 1: 
try: 
if self.exit == True: 
break 
if self.clear == True: 


self.clear = False 

self.initpos = [0, 0] 

x, y, c = ifs( self.ifs_triangle.get_areas(), 
self.ifs_triangle.get_eqs(), self.initpos, 100 

self.initpos = [x[-1], y[-1]] 

self.ax2.clear() 


x, y, c = ifs( self.ifs_triangle.get_areas(), 
self.ifs_triangle.get_eqs(), self.initpos, ITER_COl 

if np.max(np.abs(x)) < 1000000 and np.max(np.abs(y)) < 
self.initpos = [x[-1], y[-1]] 
wx.CallAfter( draw_points, x, y, c ) 

time.sleep(0.05) 

except: 
pass 


EJE] 


用 户 修改 三 角形 之 后 ， 需 要 重新 迭代 ， 并 绘制 分 形 图 案 ， 三 角形 的 改变 通过 
IFSTriangles.version 属性 通知 给 IFSDesigner， 在 IFSTriangles 中 ， 三 角形 改变 之 
后 ， 将 运行 : 





self.version += 1 


在 IFSDesigner 中 监听 version 属 性 的 变化 : 


@on_trait_change("ifs_triangle.version") 
def on_ifs_version_changed(self): 


当 三 角形 更 新 时 ， 重 新 绘制 所 有 的 迭代 点 


self.clear = True 


当 IFSDesigner.clear 为 True 时 ， 真 正 进行 迭代 运算 的 ifs_calculate 方 法 就 知道 需要 
重新 计算 了 。 
L-System 分 形 


前 面 所 绘制 的 分 形 图 案 都 是 都 是 使 用 数学 画 数 的 迄 代 产生 ， 而 L-System 分 形 则 是 采 
用 符号 的 递归 和 迭代 产生 。 首 先 如 下 定义 几 个 有 含义 的 符号 : 

。F : 向 前 走 固定 单位 

。+ : 正方 向 旋转 固定 单位 

。- : 负 方向 旋转 固定 单位 


使 用 这 三 个 符号 我 们 很 容易 描述 下 图 中 由 4 条 线段 构成 的 图 案 : 
F+F- -F+F 


如 果 将 此 符号 串 中 的 所 有 F 都 替换 为 F+F--F+F， 就 能 得 到 如 下 的 新 字符 串 : 


F+F- -F+F+F+F- -F+F--F+F--F+F+F+F--F+F 


如 此 蔡 换 和 迭代 下 去 ， 并 根据 字 串 进行 绘图 (符号 + 和 -分 别 正 负 旋转 60 度 )， 可 得 到 如 
下 的 分 形 图 案 : 


OSNO ANR 
wed cated tar 


使 用 F+F--F+F 人 迭代 的 分 形 图 案 

除了 F, +, - 之 外 我 们 再 定义 如 下 几 个 符号 : 

ef: 向 前 走 固 定单 位 ， 为 了 定义 不 同 的 迭代 公式 
eo [: 将 当前 的 位 置 入 堆栈 

e ]: 从 堆栈 中 读 取 坐标 ， 修 改 当 前 位 置 

e S: 初始 迭代 符号 


所 有 的 符号 (包括 上 面 未 定义 的 ) 都 可 以 用 来 定义 选 代 ， 过 引入 两 个 方 括 号 符号 ， 
使 得 我 们 能 够 描述 分 岔 的 图 案 。 


例如 下 面 的 符号 迭代 能 够 绘制 出 一 棵 植物 : 


Se > x 
X -> F-[[X]+X]+F[+FX]-X 
F -> FF 


我 们 用 一 个 字典 定义 所 有 的 迭代 公式 和 其 它 的 一 些 绘 图 信息 


{ 
"X": "F-[[X]+X]+F[+FX] -X", "E": "FR", VS ke 
"direct":-45, 
"angle": 25, 
VATE GE 
"title":"Plant" 

} 

其 中 : 


e direct: 是 绘图 的 初始 角度 ， 通 过 指定 不 同 的 值 可 以 旋转 整个 图 案 
e angle: 定义 符号 +,- 旋 转 时 的 角度 ， 不 同 的 值 能 产生 完全 不 同 的 图 案 
e iter: 迭代 次 数 


下 面 的 程序 将 上 述 字 上 典 转换 为 需要 绘制 的 线段 坐标 : 


class L_System(object): 
def _ init__(self, rule): 
info = rule['S'] 
for i in range(rule['iter']): 
ninfo = [] 
for c in info: 
if c in rule: 
ninfo.append(rule[c]) 


else: 
ninfo.append(c) 
info = "",join(ninfo) 
self.rule = rule 
self.info = info 


def get_lines(self): 


d = self.rule['direct' ] 
a = self.rule['angle' ] 
p = (0.0, 0.0) 
1=1.0 
lines = [] 
stack = [] 
for c in self .info: 
D C ai AE 


r=d* pi / 180 
= p[0] + l*cos(r), p[1] + 1*sin(r) 
T eaaa p[1]), (t[0], t[1]))) 


ct 


oO 


elif c == "+": 
d +a 
elif c == "-": 
d -= a 
elif c == "[": 
stack.append((p,d)) 
elif c == "J": 
p, d = stack[-1] 
del stack[-1] 
return lines 


我 们 使 用 matplotlib 的 LineCollection 绘 制 所 有 的 直线 : 


import matplotlib.pyplot as pl 
from matplotlib import collections 


# rule = {...} 此 你 省 略 rule 的 定义 
lines = L_System(rule).get_lines() 


fig = pl.figure() 

ax = fig.add_subplot(111) 

linecollections = collections.LineCollection(lines) 
ax.add_collection(linecollections, autolim=True) 
pl.show( ) 


下 面 是 几 种 L-System 的 分 形 图 案 ， 绘 制 此 图 的 完整 程序 请 参照 绘制 L-System 的 分 
形 图 。 





几 种 L-System 的 迭代 图 案 


关于 本 书 的 编写 


为 了 编写 此 书 ， 我 评价 了 许多 写 书 的 软件 ， 最 终 决定 使 用 Sphinx 和 reStructuredText 
作为 写 书 的 工具 。 随 着 章节 的 逐渐 增加 ， 我 越 来 越 觉 得 当初 的 选择 是 正确 的 。 


本 书 的 编写 工具 


本 书 采用 reStructuredText(rst) 格式 的 文本 编写 ， 然 后 用 Sphinx 和 将 reStructuredText 
文件 自动 转换 为 html 格 式 的 文件 。 采 用 Leo 管 理 和 组 织 所 有 的 文档 。 用 proTeXt 将 
latex 格 式 的 数学 公式 转换 为 PNG 图 片 。 


e reStructuredText : 一 种 结构 化 文本 格式 ， 它 提供 了 对 写 书 所 需 的 各 种 元 素 的 
支持 。 例 如 章节 、 和 链接 、 格 式 、 图 片 以 及 语法 高 之 等 等 。 


e Sphinx : 将 一 系列 reStructuredText 文 本 转换 成 各 种 不 同 的 输出 格式 ， 并 自动 
制作 交叉 引用 (cross-references)、 索 引 等 。 也 就 是 说 ， 如 果 某 目录 中 有 一 系 
列 的 reStructuredText 格 式 的 文档 ， Sphinx 可 以 制作 一 份 组 织 得 非常 完美 的 
HTML 文 件 。 


。 Leo: 以 树 状 结构 管理 文本 、 代 码 的 编辑 器 ， 可 以 用 它 来 进行 数据 组 织 和 项 目 
管理 。 我 使 用 它 管 理 构 成 本 书 的 所 有 rst 文 档 、python 程 序 以 及 图 片 和 笔记 。 下 
面 是 使 用 Leo 编 写本 书 时 的 一 个 例子 


= * pydoc_leo in AR heii — =O) x) 
ae Edit Outline PI mds Window Help 


| script-button | show-tree hide-tree make-html Ke} ©. 


Sad dhs hada 下 面 是 用 TVTK 实 现 上 面 的 显示 圆锥 的 例子 : 


o) Indices and tables 

日 入 门 
al @auto-rst install.rst 
a| @auto-rst intro.rst 
5 @auto-rst numpy_intro.rst 
9 @auto-rst traits_intro.... 
5 @auto-rst traitsUI_intr... 
5) @auto-rst chaco_intro.rst 
可 @auto-rst fft_study.rst 
5 @auto-rst tvtk_intro.rst 
9 @auto-rst tvtk_and_vtk.... 
日 :Ca TVTK 的 改进 

Ea] TVTK 的 基本 用 法 















































.. literalinclude:: examples/tvtk_cone_example.py 








H-A 











OR ERAEN 导 多 ， 从 中 我 们 可 以 看 到 TVTK 的 一 
些 重要 的 更 


ff 






冉 


* tvtk 用 from enthought.tvtk.api import tvtk 语 句 载 入 


w 


























* tvtk 的 类 名 为 VTK 的 类 名 除去 前 绎 "vtk"。 有 些 类 名 在 "vtk" 之 后 是 数字 : 
vtk3DSImporter， 由 于 Python 的 标示 符 首 字符 不 能 为 数字 ， 因 此 tvtk 对 此 
进行 特殊 处 理 : 如 果 首 字符 为 数字 ， 则 用 其 英文 单词 代替 : 


p-e 












o) Trait 属 性 ThreeDSImporter。 
o) 序列 化 (Pickling) 
= eee * tvtk 对 象 的 方法 名 按照 Enthought 的 一 贯 用 法 ， 采 用 下 划 线 连接 单词 : 例 


BEARTA 如 如 果 VTk 中 的 AddItem， 将 对 应 tvtk 中 的 add_item。 


Minibuffer: insert State 


| pydoc--> 入 门 -->@auto-rst tytk_and_vtkrst-->TYTK 的 改进 -->TYTK 的 基本 用 法 7 





[line: 1, cot 0, fook 0 
编写 本 书 所 使 用 的 Leo 编 辑 器 的 界面 
e PicPick, Greenshot : 界面 截图 工具 。 


Y SHOR TIS 





在 使 用 上 述 工具 编写 本 书 时 ， 为 了 达到 完美 的 效果 ， 我 对 这 些 工 具 做 了 一 些 配置 和 
修改 的 工作 。 


代码 中 的 注释 


Sphinx 使 用 Pygments 进 行 代码 高 亮 的 处 理 ， 在 Pygments 的 缺 省 样式 中 ， 代 码 注释 
部 分 是 采用 斜体 字 表 示 的 ， 斜 体 的 汉字 看 起 来 十 分 别扭 ， 因 此 需要 将 缺 省 祥 式 的 斜 
体 改 为 正体 。 在 conf.py 文 件 中 有 如 下 配置 : 


# The name of the Pygments (syntax highlighting) style to use. 
pygments_style = 'sphinx' 


它 指 定 pygments 使 用 sphinx 样 式 对 代码 进行 高 亮 处 理 ， 我 没有 弄 明白 如 何 添加 自己 
定义 的 样式 ， 因 此 直接 手工 修改 定义 此 样式 的 文件 : 


%Python 安 装 目 录 %\Lib\site-packages\sphinx\highlighting.py 


将 其 中 的 Comment 的 样式 改 为 noitalic : 


styles.update({ 
Generic.Output: '#333', 
Comment: 'noitalic #408090', 
Number: '#208050', 

}) 


修改 Sphinx 的 主题 


为 了 给 文档 添加 评论 功能 ， 必 须 添加 一 部 分 javascript 代 码 ， 因 此 需要 修改 Shpinx 的 
主题 。 
。 首先 编辑 conf.py 文 件 中 如 下 的 两 个 配置 : 
# The theme to use for HTML and HTML Help pages. Major themes 


# Sphinx are currently 'default' and 'sphinxdoc'. 
html_theme = 'pydoc' 


# Add any paths that contain custom themes here, relative to tr 
html_theme_path = ["./theme" | 


4 — 








e 然后 在 conf.py 文 件 所 在 的 目录 下 创建 一 个 子 目录 theme， 将 sphinx 安 装 目录 下 
的 themes\sphinxdoc 文 件 夹 复制 到 theme 文 件 夹 下 ， 并 重 命 名 为 pydoc， 目 录 
结构 如 下 图 所 示 : 


=] source 

H- -static 
O templates 
(5) examples 
O images 
D tests 


—) theme 


日- pydoc 


I static 
layout.html 

自 theme.conf 

*| chaco introrst 


œ conf.py 


ctypes_numpy.rst 
theme 文 件 夹 的 结构 


o 编辑 layout.html 文 件 。 此 文件 是 一 个 模板 ，Sphinx 最 终 使 用 此 模板 生成 每 
个 rst 文 件 所 对 应 的 html 文 件 。 因 此 我 在 其 中 添加 了 对 我 自己 的 css 和 js 文件 
的 引用 : 














+ 








十 -出 








E-E 










<link type="text/css" href="_static/jquery-ui-1.7.2.custom.css" re. 
<link type="text/css" href="_static/comments.css" rel="stylesheet" 
<script type="text/javascript" src="_static/jquery-ui-1.7.2.custom 
<script type="text/javascript" src="_static/pydoc.js"></script> 


e 在 theme\pydocstatic 目 录 下 添加 相应 的 css 和 js 文件 。 为 了 固定 html 页 面 左 便 
的 目录 栏 ， 可 以 配置 theme\pydoc\theme.conf 中 的 stickysidebar=True， 不 过 好 


像 IE7.0 下 无 法 正常 显示 ， 因 此 在 css 文 件 中 添加 如 下 代码 ， 除 了 IE6.0 以 外 其 它 
的 浏览 器 (Firefox,IE7, Chrome) 都 能 够 正常 固定 目录 栏 : 





div.sphinxsidebar { 
position : fixed; 
left : Opx; 
top : 30pX; 
margin-left : Opx !important; 


关闭 引号 自动 转换 
在 输出 html 的 时 候 ， 如 果 使 用 Sphinx 缺 省 的 配置 ， 会 对 引号 进行 自动 转换 : 将 标准 


的 单 引 号 和 双 引 号 转换 为 Unicode 中 的 全 角 引 号 。 为 了 关闭 此 项 功能 ， 需 要 编辑 
conf.py， 进 行 如 下 设置 : 


html_use_smartypants = False 


用 latex 编 写 数 学 公式 
Sphinx 支 持 将 latex 编 写 的 数学 公式 转换 为 png 图 片 。 为 了 在 windows 下 使 用 latex,， 


我 下 载 了 proTeXt， 这 个 tex 软 件 包 的 大 小 有 700M 左 右 ， 安 装 之 后 占用 1.3G。 为 了 
告诉 Sphinx 工 具 latex 的 安装 位 置 ， 如 下 修改 make.bat 文 件 : 


%SPHINXBUILD% -D pngmath_latex="..\latex.exe" -b html %ALLSPHINXOF 
«| = =p 
然后 就 可 以 如 下 使 用 latex: 








X k = \sum {n=O}^{N-1} x_n e^{-{i 2\pi k \frac{n}{N}}} \qquad k = 
El = = 
得 到 的 输出 图 片 如 下 : 





Leo 的 配置 


Leo 的 缺 省 配置 用 起 来 很 不 习惯 : 它 的 树 状 目录 在 上 方 ， 而 且 字体 很 小 。 下 面 是 对 
Leo 的 一 些 修改 和 配置 : 


e Leo 现 在 可 以 使 用 tk 和 qt 两 个 库 。 使 用 tk 库 的 界面 用 起 来 不 习惯 ， 因 此 通过 在 启 
动 Leo 时 添加 参数 强制 使 用 qt 库 的 界面 : launchLeo.py --gui=qt 。 


© 我 个 人 很 喜欢 微软 雅 黑 的 汉字 字体 ， 但 是 由 于 雅 黑 字体 的 英文 不 是 等 宽 的 ， 
此 用 它 来 编辑 代码 的 话 就 很 不 爽 了 。 于 是 上 网 找到 了 一 个 雅 黑 和 Consolas 的 复 
BM : 
YaHei Mono 字 体 下 载 地 址 : http://hyry.dip.jp/files/yahei_mono.7z 


e 复制 一 份 leo\config\leoSettings.leo 到 同一 目录 ， 改 名 为 myLeoSettings.leo。 用 
Leo 编 辑 此 文件 ， 在 目录 树 中 找到 节点 : qtGui plugin-->@data qt-gui-plugin- 
style-sheet， 修 改 此 样式 表 中 的 字体 的 定义 ， 使 用 新 安装 的 Yahei Mono 字 体 。 


QTextEdit#richTextEdit { 


font-family: Yahei Mono; 
font-size: 17px; 


e A @settings-->Window-->@string initial_split_orientation 节 点 和 @settings-- 
>Window-->Options for new windows-->@strings[vertical,horizontal] 
initial_splitter_orientation 节 点 的 值 为 horizontal。 这 样 目 录 树 和 编辑 框 就 是 左右 
分 栏 的 了 。 


e 在 Leo 中 用 @auto-rst 输 出 rst 文 件 时 ， 会 自动 的 将 目录 树 中 的 节点 名 转换 为 rst 文 
件 中 的 标题 。 在 rst 中 标题 都 是 由 下 划 线 标 出 的 。 下 划 线 的 长 度 要 求 和 文本 的 长 
度 一 致 。 由 于 Leo 采 用 unicode 表 示 文 本 ， 因 此 汉字 的 长 度 为 1， 但 是 rst 编 译 器 
似乎 要 求 汉字 的 长 度 为 2， 因 此 对 于 Leo 的 配置 这 样 的 标题 ，rst 要 求 用 9 个 下 
划 线 符号 标识 ， 而 Leo 只 用 6 个 ， 造 成 在 编译 时 出 现 许多 警告 信息 ， 为 了 解决 这 
个 问题 ， 编 辑 leo\core\leoRst.py 文 件 中 的 underline 函 数 如 下 ， 并 且 将 其 后 的 所 
有 len(s) 都 改 为 len(ss) : 


def underline (self,s,p): 


try: 
ss = s.encode("gbk") 
except: 
try: 
ss = s.encode("shiftjis") 
except: 
SSIES 


trace = False and not g.unitTesting 


jLMatplotlib 显示 中 文 
将 中 文字 体 文件 复制 到 : 


%PythonPath%\Lib\site-packages\matplotlib\mpl-data\fonts\ttf\ 


下 ， 这 里 以 上 一 节 介 绍 的 Yahei Mono 字 体 为 例 。 
找到 Matplotlib 的 配置 文件 matplotlibrc， 全 局 配置 文件 的 路 径 : 


%Py thonPath%\Lib\site-packages\matplotlib\mpl-data\matplotlibrc 


用 户 配置 文件 路 径 : 


c:\Documents and Settings\%UserName%\ .matplotlib\matplotlibrc 


用 文本 编辑 器 打开 此 文件 ， 进 行 如 下 编辑 : 


e 找到 设置 font.family 的 行 ， 改 为 font.family : monospace, RAHA MAH 


FZ 0 
e 在 下 面 添 加 一 行 font.monospace : Yahei Mono. 


在 matplotlib 中 使 用 中 文字 符 串 时 记 住 要 用 unicode 格 式 ， 例 如 : yu" 测试 中 文 显示 "。 


用 Matplotlib 生 成 图 片 
matplotlib 提 供 了 一 个 Sphinx 的 扩展 插件 ， 可 以 使 用 ..plot 命 令 自 动 生 成 图 片 。 可 是 


这 个 插件 生成 的 图 片 的 路 径 和 本 书 所 采用 的 路 径 不 符合 ， 无 法 在 HTML 文 件 中 显示 
最 终生 成 的 图 。 因 此 我 直接 复制 下 面 两 个 文件 : 


c:\Python26\Lib\site-packages\matplotlib\sphinxext\plot_directive. | 
c:\Python26\Lib\site-packages\matplotlib\sphinxext\only_directives 


HE 


到 sourceexts 下 ， 命 名 为 plot_directive.py。 然 后 编辑 conf.py， 修 改 下 面 两 行 : 





sys.path.append(os.path.abspath('exts')) 
extensions = ['sphinx.ext.autodoc', 'sphinx.ext.doctest', 
"sphinx.ext.pngmath', 'plot_directive' | 


这 样 就 可 以 载 人 extsplot_ directive.py 扩 展 插 件 了 。 然 后 编辑 plot_directive.py 文 件 ， 
使 得 它 的 输出 符合 本 书 的 路 径 ， 并 且 除 去 大 图 和 PDF 输出 。 


在 rst 文 件 中 使 用 : 


import matplotlib.pyplot as plt 

import numpy as np 

x = np.random.randn(1000) 

plt.hist( x, 20) 

plt.grid() 

plt.title(r'Normal: $\mu=%.2f, \Sigma=%.2f$'%(x.mean(), x.std())) 
plt.show( ) 


Normal: u =0.03.0=0.98 
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用 Graphviz 绘 


Sphinx 可 以 调用 Graphviz 绘 制 流程 图 ， 首 先 下载 Graphviz 的 Windows 安 装 包 进行 安 
装 ， 假 设 安 装 目 录 为 cgraphviz。 
Graphviz 的 下 载 地 址 : http://www.graphviz.org 


编辑 conf.py 配 置 文件 ， 在 extensions 列表 定义 的 最 后 添加 一 
项 : 'sphinx.ext.graphviz'. 


如 下 编辑 make.bat 文 件 ， 配 置 dot.exe 的 执行 路 径 : 


. graphviz:: 
digraph GraphvizDemo{ 
node [fontname="Yahei Mono" shape="rect"]; 
edge [fontname="Yahei Mono" fontsize=10]; 


node1[1label=" 开 始 "]， 
node2[1label=" 正 常 "]， 


node1->node2[label=" 测 试 "]， 


输出 图 为 : 


![digraph GraphvizDemot{ node [fontname="Yahei Mono" shape="rect"]; edge 
[fontname="Yahei Mono" fontsize=10]; 


node1[label=" 开 始 "]， 
node2[1label=" 正 常 "]， 


node1-&gt;node2[label=" 测 试 "]; 


H(img/graphviz-691597b9de6125817b93aaad942bf30f1e3d5346.png) 


制作 CHM 文 档 


Sphinx 支 持 输 出 为 CHM 文 档 格式 ， 只 需要 运行 make htmlhelp 即 可 。 但 是 此 命令 输 
tl 录 文 件 (扩展 名 为 .hhc)， 却 不 支持 中 文 。 为 了 解决 这 个 问题 ， 我 进行 了 如 下 
Sry : 


e sphinx 的 安装 目录 下 找到 buildershtmlhelp.py， 将 其 复制 一 份 ， 改 名 为 
htmlhelpcn.py。 输 出 CHM 文 档 的 程序 都 在 这 里 面 。 


e 修改 builders _init _.py 文 件 ， 在 其 最 后 的 BUILTIN_BUILDERS 字 上 典 定义 中 添 


'htmlhelpcn': ('htmlhelpcn', 'HTMLHelpBuilder' ) 


e 修改 make.bat 文 件 ， 在 其 中 添加 : 


if "%1" == "htmlhelpcn" ( 
%SPHINXBUILD% -b htmlhelpcn %ALLSPHINXOPTS% build/htmlh 
echo. 


echo.Build finished; now you can run HTML Help Workshop 
.hhp project file in build/htmlhelpcn. 
goto end 


a ~~- 


e 编辑 htmlhelpcn.py 文 件 ， 找 到 project_ template 字 符 串 的 定义 ， 修 改 其 中 的 
Language 定 义 为 Language=0x804。 


e 反复 运行 make.bat htmlhelpcn 命 舍 ， 根 据 输出 的 错误 提示 修改 htmlhelpcn.py， 
将 其 中 几 处 编码 错误 的 地 方 都 添加 .encode("gb2312")。 其 中 有 一 处 : 





f.write(item.encode('ascii', 'xmlcharrefreplace')) 
# 改 为 --&gt 


f.write(item.encode('gb2312')) 


。 如 果 在 rst 文 档 中 给 图 片 添加 了 中 文 说 明 的 话 ， 有 可 能 输出 的 CHM 文 件 中 看 不 到 
图 片 。 


o make.bat htmlhelpcn 正 常 运行 之 后 ， 运 行 下 面 的 命令 输出 制作 CHM 文 
件 : 


"C:\Program Files\HTML Help Workshop\hhc.exe" htmlhelpcn\sc 


“| = 








CHM+#r A Flash +Œ] 


用 如 下 的 reStructuredText 的 raw #843 FI LAZEhtm| Be A Flash z E 


<OBJECT CLASSID="clsid:D27CDB6E-AE6D -11cf -96B8 - 444553540000" WIDTH: 
CODEBASE="http://active.macromedia.com/flash5/cabs/swflash.cab#ve 

<PARAM NAME="movie" VALUE="img/fft_study_04.swf"> 

<PARAM NAME="play" VALUE="true"> 

<PARAM NAME="loop" VALUE="false"> 

<PARAM NAME="wmode" VALUE="transparent"> 

<PARAM NAME="quality" VALUE="high"> 

<EMBED SRC="img/fft_study_04.swf" width="589" HEIGHT="447" quality: 
loop="false" wmode="transparent" TYPE="application/x-shockwave- flé 
PLUGINSPAGE= 
"http: //www.macromedia.com/shockwave/download/index.cgi?P1_Prod_VvVe 

</EMBED> 

</OBJECT> 


ss 


cage Help ie geass bal Nie 因此 CHM 中 看 不 到 flash 动 
， 只 需要 在 机 入 flash 动 画 的 html 之 后 添加 一 





<img src="img/fft_study_04.swf" style="visibility:hidden"/> 


这 样 Html Help Workshop 就 会 把 件 _study_04.swf 文 件 添加 进去 ， 由 于 使 用 隐藏 的 
CSS， 页 面 中 也 不 会 把 它 当 作 图 片 显示 出 来 。 


制作 PDF 文档 


调用 make latex 命 令 可 以 输出 为 latex 格 式 的 文件 ， 后 调用 xelatex scipydoc.tex 
即 可 将 其 转换 为 PDF 文件 ，xelatex 是 proTeXt 自 带 的 命令 。 制 作 PDF 文 档 时 同样 有 
中 文 无 法 显示 的 问题 ， 按 照 以 下 步骤 解决 : 


。 编辑 文档 的 配置 文件 conf.py， 在 最 后 的 Options for LaTeX output ELK, AR 
加 如 下 代码 ， 这 段 文 字 将 添加 到 最 终 输出 的 tex 文 件 中 ， 这 里 的 Yahei Monot 
以 修改 为 你 想 要 的 中 文字 体 名 : 


latex_preamble = r""" 


\usepackage{float} 

\textwidth 6.5in 

\oddsidemargin -0.2in 

\evensidemargin -0.2in 

\usepackage{ccaption} 

\usepackage{fontspec, xunicode, xltxtra} 
\setsansfont{Microsoft YaHei} 

\setromanfont{Microsoft YaHei} 

\setmainfont{Microsoft YaHei} 

\setmonofont{Yahei Mono} 

\XeTeXlinebreaklocale "zh" 

\XeTeXlinebreakskip = Opt plus ipt 
\renewcommand{\baselinestretch}{1.3} 
\setcounter{tocdepth}{3} 

\captiontitlefont{\small\sffamily} 

\captiondelim{ - } 

\renewcommand\ today {\number \year 4 \number \month# \number \day A} 
\makeatletter 

\renewcommand* \l@subsection{\@dottedtocline{2}{2.0em}{4.0em}} 
\renewcommand* \l@subsubsection{\@dottedtocline{3}{3em}{5em}} 
\makeatother 

\titleformat{\chapter}[display] 

{\bfseries\Huge} 

{\filleft \Huge 第 \hspace{2 mm} \thechapter \hspace{4 mm} =} 
{4ex} 

{\titlerule 

\vspace{2ex}% 

\filright} 

[\vspace{2ex}% 

\titlerule] 
%\definecolor{VerbatimBorderColor}{rgb}{0.2,0.2,0.2} 
\definecolor{VerbatimColor}{rgb}{0.95,0.95,0.95} 


mum decode("utf-8") 


通过 renewcommand 命 令 将 输出 的 PDF 文档 中 的 一 部 分 英文 修改 为 中 文 。 


不 知 何故 ， 在 latex_preamble 中 添加 修改 插图 标题 前 缀 的 命令 没有 作用 ， 因 此 通 
下 面 的 命令 在 正文 中 添加 转换 前 缀 的 renewcommand : 


raw:: latex 


\renewcommand\partnamef{ 部 分 } 
\renewcommand{\chaptermark}[1]{\markboth{ 第 \thechapter\ = \hs 
N\fancyhead[LE,RO]{ 用 Python 做 科学 计算 } 
\renewcommand{\figurename}{\textsc{ }} 


= _ : 








e 调整 conf.py 中 的 其 它 选项 : 


latex_paper_size = 'a4' 
latex_font_size = '11ipt' 
latex_use_modindex = False 


。 运行 下 面 的 命令 输出 PDF 文档 ， 使 用 nonstopmode， 即 使 出 现 错误 也 不 暂停 运 
行 。 


xelatex -interaction=nonstopmode scipydoc.tex 


还 有 一 些 latex 配 置 没 有 找到 如 何 使 用 reStructuredText 进 行 设置 ， 因 此 写 了 一 个 
Python 的 小 程序 读 取 输 出 的 tex 文 件 ， 蔡 换 其 中 的 一 些 latex 命 令 : 


。 将 begin{figure}[htbp] 改 为 begin{figure}[H}， 这 样 能 保证 图 和 文字 保持 tex 中 的 前 
后 关系 ， 而 不 会 对 图 进行 自动 排版 
e 在 \tableofcontents 之 前 添加 \renewcommand\contentsnamef{ 目 录 }， 将 目录 标 
题 的 英文 改 为 中 文 ， 此 段 配置 在 latex_preamble 中 定义 无 效 
添加 PDF 封面 
使 用 作 图 软件 设计 封面 图 片 之 后 ， 使 用 图 片 转 PDF 工具 将 其 转换 为 一 个 只 有 一 页 的 
PDF 文档 coverpdf : 
图 片 转 PDF 工具 下 载 地 址 : http://www.softinterface.com 


然后 使 用 PDF 合并 工具 将 coverpdf 和 正文 的 PDF 文件 进行 合并 。 我 在 网 络 上 找 了 很 
久 ， 终 于 找到 了 下 面 这 个 能 够 维持 内 部 链接 和 书签 的 免费 的 合并 工具 : 


PDF 工具 PDFsam 下 载 地 址 : http://www.pdfsam.org 
PDFsam 提 供 了 界面 和 命令 行 方式 ， 界 面 方 式 很 容易 使 用 ， 但 是 为 了 一 个 批 处 理 产 


生 最 终 PDF 文 档 我 需要 使 用 命令 行 方式 ， 下 面 是 使 用 命令 行进 行 PDF 文 档 合 并 的 批 
义理 程序 : 


set MERGE=java -jar "c:\Program Files\pdfsam\lib\pdfsam-console-2.: 
%MERGE% -f cover.pdf -f scipydoc.pdf -o %CD%\scipydoc2.pdf concat 


SSS 
。 -f{ 参 数 指定 输入 的 PDF 文件 名 


。 -0 参数 指定 输出 的 PDF 文件 名 ， 注 意 必 须 使 用 绝对 路 径 ， 因 此 这 里 使 用 %CD% 
将 相对 路 径 转 换 为 绝对 路 径 。 


输出 打包 的 批 处 理 
下 面 是 同时 输出 zip, chm, pdf 文件 的 批 处 理 命令 : 





rename html scipydoc 
"c:\Program Files\7-Zip\7z.exe" a scipydoc.zip scipydoc 
rename scipydoc html 


"C:\Program Files\HTML Help Workshop\hhc.exe" htmlhelpcn\scipydoc.| 
copy htmlhelpcn\scipydoc.chm . /y 


cd latex 

xelatex -interaction=nonstopmode scipydoc.tex 
cor 

copy latex\scipydoc.pdf . /y 








HTML 的 中 文 搜索 


由 于 Sphinx 不 懂 中 文 分 词 ， 因 此 它 所 生成 的 搜索 索引 文件 searchindex.js 中 的 中 文 
单词 分 的 不 正确 。 为 了 修正 这 个 问题 ， 我 写 了 一 个 Sphinx 扩 展 chinese_search.py， 
使 用 中 文 分 词 库 smallseg 生 成 索引 文件 中 的 中 文 单词 。 


smallseg 中 文 分 词 库 地 址 : http://code.google.com/p/smallseg 
下 面 是 这 个 扩展 的 完整 源 程序 : 


from os import path 


import re 
import cPickle as pickle 


from docutils.nodes import comment, Text, NodeVisitor, SkipNode 


from sphinx.util.stemmer import PorterStemmer 
from sphinx.util import jsdump, rpartition 


from smallseg import SEG 
DEBUG = False 
word_re = re.compile(r'\w+(?u)') 


stopwords = set(""" 

a and are as at 

be but by 

for 

if in into is it 
near no not 


that the their then there these they this to 
was will with 
"nN .Split()) 


if DEBUG: 
testfile- = file("testfile. txt", "wb") 


class _JavaScriptIndex(object): 
The search index as javascript file that calls a function 
on the documentation search object to register the index. 


PREFIX 
SUFFIX 


'"Search.setIndex(' 


ie 


def dumps(self, data): 
return self.PREFIX + jsdump.dumps(data) + self .SUFFIX 


def loads(self, s): 
data = s[len(self.PREFIX):-len(self.SUFFIX) ] 
if not data or not s.startswith(self.PREFIX) or not \ 
s.endswith(self.SUFFIX): 
raise ValueError('invalid data') 
return jsdump.loads(data) 


def dump(self, data, f): 
f.write(self.dumps(data) ) 


def load(self, f): 
return self.loads(f.read() ) 


js_index = _JavaScriptIndex() 


class Stemmer(PorterStemmer ): 
All those porter stemmer implementations look hideous. 
make at least the stem method nicer. 


def stem(self, word): 
word = word. lower() 
return word 
#return PorterStemmer.stem(self, word, ©, len(word) - 1) 


class WordCollector(NodeVisitor): 


A special visitor that collects words for the ‘IndexBuilder . 


def _ init__(self, document): 
NodeVisitor. init__(self, document) 
self.found_words = [] 


def dispatch_visit(self, node): 
if node. class _ is comment: 


raise SkipNode 
if node. class _ is Text: 
words = seg.cut(node.astext().encode("utf8") ) 
words.reverse() 
self .found_words.extend(words) 


class IndexBuilder(object): 
Helper class that creates a searchindex based on the doctrees 
passed to the ‘feed method. 
formats = { 
'jsdump': jsdump, 
'pickle': pickle 
} 


def _ init (self, env): 
self.env = env 
self._stemmer = Stemmer () 
# filename -> title 
self._titles = {} 
# stemmed word -> set(filenames) 
self._mapping = {} 
# desctypes -> index 
self._desctypes = {} 


def load(self, stream, format): 
"""Reconstruct from frozen data. """ 
if isinstance(format, basestring): 
format = self.formats[format] 
frozen = format.load(stream) 
# if an old index is present, we treat it as not existing. 
if not isinstance(frozen, dict): 
raise ValueError('old format' ) 
index2fn = frozen['filenames' ] 
self. titles = dict(zip(index2fn, frozen['titles'])) 
self._mapping = {} 
for k, v in frozen['terms'].iteritems(): 
if isinstance(v, int): 
self. _mapping[k] = set([index2fn[v]]) 
else: 
self. _mapping[k] = set(index2fn[i] for i in v) 
# no need to load keywords/desctypes 


def dump(self, stream, format): 
"""Dump the frozen index to a stream.""" 
if isinstance(format, basestring): 
format = self.formats[format ] 
format.dump(self.freeze(), stream) 


def get_modules(self, fn2index): 
rv = {} 


for name, (doc, _, _, _) in self.env.modules.iteritems(): 


def 


def 


def 


def 


if doc in fn2index: 
rv[name] = fn2index[doc] 
return rv 


get_descrefs(self, fn2index): 

rv = {} 

dt self. _desctypes 

for fullname, (doc, desctype) in self.env.descrefs.iteriter 
if doc not in fn2index: 


continue 
prefix, name = rpartition(fullname, '.') 
pdict = rv.setdefault(prefix, {}) 
try: 
i = dt[desctype] 
except KeyError: 
i = len(dt) 


dt[desctype] = i 
pdict[name] = (fn2index[doc], i) 
return rv 


get_terms(self, fn2index): 
rv = {} 
for k, v in self._mapping.iteritems(): 
if len(v) = 1: 
fn, =v 
if fn in fn2index: 
rv[k] = fn2index[fn] 
else: 
rv[k] = [fn2index[fn] for fn in v if fn in fn2inde> 
return rv 


freeze(self): 
"""Create a usable data structure for serializing.""" 
filenames = self._titles.keys() 
titles = self._titles.values() 
fn2index = dict((f, i) for (i, f) in enumerate(filenames ) ) 
return dict( 
filenames=filenames, 
titles=titles, 
terms=self.get_terms(fn2index), 
descrefs=self.get_descrefs(fn2index), 
modules=self.get_modules(fn2index), 
desctypes=dict((v, k) for (k, v) in self. _desctypes.ite 
) 


prune(self, filenames): 
"""Remove data for all filenames not in the list.""" 
new_titles = {} 
for filename in filenames: 
if filename in self._titles: 
new_titles[filename] = self. _titles[filename ] 
self._titles = new_titles 
for wordnames in self. _mapping.itervalues(): 


wordnames.intersection_update(filenames ) 


def feed(self, filename, title, doctree): 
"""Feed a doctree to the index.""" 
self. _titles[filename] = title 


visitor = WordCollector(doctree) 
doctree.walk(visitor) 


def add_term(word, prefix='', stem=self._stemmer.stem): 
word = stem(word) 
word = word.strip(u"! @#$%*&*()_+-*/\\\";, .[] {}<>") 
if len(word) <= 1: return 
if word.encode("utf8").isalpha() and len(word) < 3: ret 
if word.isdigit(): return 
if word in stopwords: return 


try: 
float (word) 
return 
except: 

pass 


if DEBUG: 
testfile.write("%s\n" % word.encode("utf8") ) 
self. _mapping.setdefault(prefix + word, set()).add( file 


words = seg.cut(title.encode("utf8") ) 
for word in words: 
add_term(word) 


for word in visitor.found words: 
add_term(word) 


def load_indexer(self): 
def func(docnames) : 
print "######HHHHHHHHH CHINESE INDEXER ###############" 
self.indexer = IndexBuilder(self.env) 
keep = set(self.env.all_docs) - set(docnames) 


try: 
f = open(path.join(self.outdir, self.searchindex_filené 
try: 
self.indexer.load(f, self.indexer_format) 
finally: 
f.close() 
except (I0Error, OSError, ValueError): 
if keep: 


self.warn('search index couldn\'t be loaded, but mn 
‘documents will be built: the index will 
‘incomplete. ') 
# delete all entries for files that will be rebuilt 
self .indexer.prune(keep) 
return func 


def builder_inited(app): 


if app.builder.name == 'html': 
print 中 | 
global seg 
seg = SEG() 


app.builder.load_indexer = load_indexer(app.builder ) 


def setup(app): 
app.connect('builder-inited', builder_inited) 


‘| = eg 








PDF 的 页 码 和 图 编号 参照 


Sphinx 生 成 的 tex 文 件 没 有 使 用 label 和 \ref 进 行 编号 引用 ， 而 是 生成 一 些 链接 ， 这 些 
链接 虽然 方便 电子 版 的 阅读 ， 可 是 打印 出 来 之 后 就 毫 无 用 处 了 ， 因 此 我 守 了 一 个 扩 
展 latex_ref.py 为 最 终生 成 的 PDF 添加 编号 引用 功能 ， 这 个 扩展 添加 了 三 个 role : 
tlabel, tref, tpageref， 分 别 对 应 tex 的 \label, \ref, \pageref。 


下 面 是 完整 的 源 程序 : 


# -*- coding: utf-8 -*- 
from docutils import nodes, utils 


class tref(nodes.Inline, nodes.TextElement): 
pass 


class tlabel(nodes.Inline, nodes.TextElement): 
pass 


class tpageref(nodes.Inline, nodes.TextElement): 
pass 


def tref_role(role, rawtext, text, lineno, inliner, options={}, cor 
data = text.split(",") 
if u" 图 " in data[0]: 
name = U" 图 " 
pos = data[0][0] 
ref = data[1] 
return [tref(name=name, ref=ref, pos=pos)], [] 
return [],[] 
def tlabel_role(role, rawtext, text, lineno, inliner, options={}, « 
return [tlabel(latex=text)], [] 


def tpageref_role(role, rawtext, text, lineno, inliner, options={}, 
return [tpageref(latex=text)], [] 


def latex_visit_ref(self, node): 
self .body.append(r"%s\ref{%s}" % (node['name'], node['ref'])) 
raise nodes.SkipNode 


def html_visit_ref(self, node): 
self .body.append(r'<a href="#%s">%S%S</a>' % (node['ref'], node 
raise nodes.SkipNode 


def latex_visit_label(self, node): 
self .body.append(r"\label{%s}" % node['latex']) 
raise nodes.SkipNode 


def latex_visit_pageref(self, node): 
self .body.append(r"\pageref{%s}" % node['latex']) 
raise nodes.SkipNode 


def empty_visit(self, node): 
raise nodes.SkipNode 


def setup(app): 
app.add_node(tref, latex=(latex_visit_ref, None), text=(empty_vis 
app.add_node(tlabel, latex=(latex_visit_label, None), text=(empt\ 
app.add_node(tpageref, latex=(latex_visit_pageref, None), text=(« 


app.add_role('tref', tref_role) 
app.add_role('tlabel', tlabel_role) 
app.add_role('tpageref', tpageref_role) 


a nes 





ReST 使 用 心得 


添加 图 的 编号 和 标题 

使 用 figure 命 邻 插 和 人 带 编号 和 标题 的 插图 : 
，_pythonxyhome : 
. figure:: images/pythonxy_home.png 


Python(x,y) 的 启动 画面 


PDF 文子 包围 图 片 


当 给 figure 添 加 figwidth 和 align 属 性 之 后 ， 在 生成 的 latex 文 档 中 ， 将 使 用 wrapfigure 
生成 图 。 为 了 和 前 面 的 段落 之 间 添 加 一 个 换行 符 ， 使 用 一 个 斜 杠 空格 。 


. literalinclude:: examples/tvtk_cone.example. py 


. literalinclude:: example.c 
: language: c 


未 解决 的 问题 
数学 公式 输出 不 正确 


有 时 候 数学 公式 的 输出 不 正确 ， 某 些 数 学 符号 不 能 显示 ， 可 是 多 试 几 次 之 后 就 正常 
了 ， 不 知道 是 什么 原因 。 


Leo 不 能 配置 目录 树 和 编辑 框 的 宽度 比例 


每 次 Leo 开 启 之 后 目录 树 和 编辑 框 的 宽度 是 相等 的 ， 看 上 去 很 不 协调 。 而 且 修 改 
mySettings.leo 中 的 相关 配置 也 不 能 解决 ， 不 明白 是 什么 问题 。 目 前 的 解决 方法 是 
添加 两 个 工具 按钮 : show-tree 和 hide-tree， 这 样 点 击 一 下 show-tree 就 会 将 目录 树 
和 编辑 框 改 为 1:3 的 比例 ; 而 点 击 hide-tree 则 能 隐藏 目录 树 : 


# -*- coding: utf-8 -*- 
from enthought.traits.api import \ 
Str, Float, HasTraits, Property, cached_property, Range, Instar 


from enthought.chaco.api import Plot, AbstractPlotData, ArrayPlotDé 


from enthought.traits.ui.api import \ 
Item, View, VGroup, HSplit, ScrubberEditor, VSplit 


from enthought.enable.api import Component, ComponentEditor 
from enthought.chaco.tools.api import PanTool, ZoomTool 


import numpy as np 


# Bint ote eae 

scrubber = ScrubberEditor( 
hover_color = OXFFFFFF, 
active_color OxAOCD9E, 
border_color 0x808080 


) 


# 取 FFT 计 算 的 结果 fredqs 中 的 前 n 项 进行 合成 ， 返 回合 成 结果 ， 计 算 1oops 个 周期 的 波形 
def fft_combine(freqs, n, loops=1): 
length = len(freqs) * loops 
data = np.zeros(length) 
index = loops * np.arange(0, length, 1.0) / length * (2 * np.p: 
for k, p in enumerate(freqs[:n]): 
if k != 0: p *= 2 # 除去 直流 成 分 之 外 ， 其 余 的 系数 都 *2 
data += np.real(p) * np.cos(k*index) # 余弦 成 分 的 系数 为 实数 部 
data -= np.imag(p) * np.sin(k*index) # 正弦 成 分 的 系数 为 负 的 虚 妆 
return index, data 


class TriangleWave(HasTraits): 
# 指定 三 角 波 的 最 窗 和 最 宽 范 围 ， 由 于 Range 似 乎 不 能 将 常数 和 traits 名 混用 
# 所 以 定义 这 两 个 不 变 的 trait 属 性 
low = Float(0.02) 
hi = Float(1.0) 


# 三 角 波 形 的 宽度 
wave_width = Range("low", "hi", 0.5) 


# 三 角 波 的 顶点 C 的 X 轴 坐标 
length_c = Range("low", "wave_width", 0.5) 


# 三 角 波 的 定点 的 y 轴 坐标 
height_c = Float(1.0) 


# FFT 计 算 所 使 用 的 取样 点 数 ， 这 里 用 一 个 Enum 类 型 的 属性 以 供用 户 从 列表 中 选择 
fftsize = Enum( [(2**x) for x in range(6, 12)]) 


# FFT 频 谱 图 的 X 轴 上 限 值 
fft_graph_up_ limit = Range(0, 400, 20) 


# 用 于 显示 FFT 的 结 
peak_list = Str 


# 采用 多 少 个 频率 合成 三 角 波 
N = Range(1, 40, 4) 


# 保存 绘图 数据 的 对 象 
plot_data = Instance(AbstractPlotData) 


# 绘制 波形 图 的 容器 


plot_wave = Instance(Component ) 


# 绘制 FFT 频 谱 图 的 容器 
plot_fft = Instance(Component) 


# 包括 两 个 绘图 的 容器 
container = Instance(Component) 


# 设置 用 户 界面 的 视图 ， 注意 一 定 要 指定 窗口 的 大 小 ， 这 样 绘图 容器 才能 正常 初始 人 


view = View( 
HSplit( 
VSplit( 
VGroup ( 


Item("wave_width", editor = scrubber, label=u"} 
Item("length_c", editor = scrubber, label=u" mR: 
Item("height_c", editor = scrubber, label=u" RE 
Item("fft_graph_up_limit", editor = scrubber, - 


Item("fftsize", label=u"FFT RR"), 
Item("N"，1label=u" 合 成 波 频 率 数 ") 
) ， 


Item("peak_list", style="custom", show_label=False, 


), 
VGroup ( 


Item("container", editor=ComponentEditor(size=(600, 


orientation = "vertical" 


) ， 


resizable = True, 

width = 800, 

height = 600, 

title = u" 三 角 波 FFT 演 示 " 
) 


# 创建 绘图 的 辅助 琅 数 ， 创 建 波形 图 和 频谱 图 有 很 多 类 似 的 地 方 ， 因 此 单独 用 一 个 加 
# 减少 重复 代码 
def _create_plot(self, data, name, type="line"): 
p = Plot(self.plot_data) 
p.plot(data, name=name, title=name, type=type) 
p.tools.append(PanTool(p) ) 
zoom = ZoomTool(component=p, tool_mode="box", always_on=Fa- 
p.overlays.append( zoom) 
p.title = name 
return p 


def _ init__(self): 
# 首先 需要 调用 父 类 的 初始 化 函数 
super(TriangleWave, self).__init__() 


# 创建 绘图 数据 集 ， 暂 时 没有 数据 因此 都 赋值 为 空 ， 只 是 创建 几 个 名 字 ， 以 供 P- 
self.plot_data = ArrayPlotData(x=[], y=[], f=[], p=[], x2=| 


# 创建 一 个 垂直 排列 的 绘图 容器 ， 它 将 频谱 图 和 波形 图 上 下 排列 
self.container = VPlotContainer() 


# 创建 波形 图 ， 波 形 图 绘制 两 条 曲线 : 原始 波形 (x, y ) 和 合成 波形 (x2, y2) 
self.plot_wave = self. create plot(("x","y"), "Triangle Wan' 
self.plot_wave.plot(("x2","y2"), color="red") 


# 创建 频谱 图 ， 使 用 数据 集中 的 f 和 p 
self.plot_fft = self._create_plot(("f","p"), "FFT", type=' 


# 将 两 个 绘图 容器 添加 到 垂直 容器 中 
self.container.add( self.plot_wave ) 
self.container.add( self.plot_fft ) 


# 设置 

self.plot_wave.x_axis.title = "Samples" 
self.plot_fft.x_axis.title = "Frequency pins" 
self.plot_fft.y_axis.title = "(dB)" 
# 改变 fftsize 为 1024， 因 为 Enum 的 默认 缺 省 值 为 枚 举 列表 中 的 第 一 个 值 
self.fftsize = 1024 


# FFT 频 谱 图 的 x 轴 上 限 值 的 改变 事件 处 理 函 数 ， 将 最 新 的 值 赋 值 给 频谱 图 的 响应 属性 
def _fft_graph_up_limit_changed(self): 
self.plot_fft.x_axis.mapper.range.high = self.fft_graph_up_ 


def _N _changed(self): 
self .plot_sin_combine() 


# 2Atrait klt k F LERRA, ALAR@on_trait_changeigz# 
@on_trait_change("wave_width, length_c, height_c, fftsize") 
def update _plot(self): 

# 计算 三 角 波 

global y_data 

x_data = np.arange(0, 1.0, 1.0/self.fftsize) 

func = self.triangle_func() 

# func RAY RG (4 sR til 44 RAKE Loat64 

y_data = np.cast["float64"](func(x_data) ) 


# 计算 频谱 
fft_parameters = np.fft.fft(y_data) / len(y_data) 


# 计算 各 个 频率 的 振幅 
fft_data = np.clip(20*np.1logi0(np.abs(fft_parameters) )[:se- 


# 将 计算 的 结果 写 进 数据 集 

self.plot_data.set_data("x", np.arange(0, self.fftsize)) # 
self.plot_data.set_data("y", y_data) 
self.plot_data.set_data("f", np.arange(0, len(fft_data))) ? 
self.plot_data.set_data("p", fft_data) 


# 合成 波 的 x 坐 标 为 取样 点 ， 显 示 2 个 周期 
self.plot_data.set data("x2", np.arange(0, 2*self.fftsize). 


# 更 新 频谱 图 X 轴 上 限 
self._fft_graph_up_limit_changed() 


# 将 振幅 大 于 -80dB 的 频率 输出 

peak_index = (fft_data > -80) 

peak_value = fft_data[peak_index][:20] 

result = [] 

for f, v in zip(np.flatnonzero(peak_index), peak_value): 
result.append("%s : %s" %(f, v) ) 

self.peak_list = "\n".join(result) 


# 保存 现在 的 fft 计 算 结 果 ， 并 计算 正弦 合成 波 
self.fft_parameters = fft_parameters 
self .plot_sin_combine() 


# 计算 正弦 合成 波 ， 计 算 2 个 周期 

def plot_sin_combine(self): 
index, data = fft_combine(self.fft_parameters, self.N, 2) 
self.plot_data.set_data("y2", data) 


# 返回 一 个 ufunc 计 算 指 定 参 数 的 三 角 波 
def triangle_func(self): 
c = self.wave_width 
c0 = self.length_c 
hc = self.height_c 
def trifunc(x): 
x = x - int(x) # 三角 波 的 周期 为 1， 因 此 只 取 x 坐 标的 小 数 部 分 进行 ; 


ap X SS CF ff 
elif x < c0: 
else: r = (c 
return r 


0.0 
= x / c0 * he 
) Z (c-c0) * hc 


a 
-X 
# AtrifuncWRele—Tufuncwe, TAEA AT, Feed! 


# 计算 得 到 的 是 一 个 0bject 数 组 ， 需 要 进行 类 型 转换 
return np.frompyfunc(trifunc, 1, 1) 


if _name__ == "__main_": 
triangle = TriangleWave() 
triangle.configure_traits() 
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最 近 更 新 


2010/01/15: 将 Mayavj 财 入 到 界面 中 

2010/01/14: 模拟 / 叭 滤波 器 的 频带 转换 

2010/01/12: 修改 Sphinx 模 板 ， 添 加 支持 中 文 搜索 的 插件 ， 中 文 分 词 库 采 用 
smallseg : http://code.google.com/p/smallseg 

2010/01/07: 巴特 沃 斯 低 通 滤波 器 ; 双 线 性 变换 


2010/01/05: 用 Sympy 计 算 球 体 体 积 ; NumPy- 快 速 处 理 数据 添加 少许 新 内 
容 ; 修改 章节 名 


2010/01/04: L-System 分 形 
2010/01/03: (tM +S 
2010/01/02: 迭代 画 数 系统 (IFS) 
2009/12/30 : Matplotlib 的 Axis 对 象 
2009/12/29 : 绘制 Mandelbrot 和 集合 


FA Python 做 科学 计算 


源 程序 集 


三 角 波 的 FFT 演 示 

在 traitsUl 中 使 用 的 matplotlib 控 件 
CSV 文 件数 据 图 形 化 工具 
NLMS 算 法 的 模拟 测试 
三 维 标 量 场 观察 器 

频谱 泄漏 和 hann 窗 
FFT RRE bi 

二 次 均衡 器 设计 

单 摆 摆 动 周期 的 计算 

双 摆 系统 的 动画 模拟 
绘制 Mandelbrot 集 合 
迭代 函数 系统 的 分 形 
绘制 L-System 的 分 形 图 


源 程 序 集 
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三 角 波 的 FFT 演 示 
相关 文档 : FFT 演 示 程 序 


本 程序 演示 各 种 三 角 波 形 的 FFT 频 谱 ， 用 户 可 以 方便 地 修改 三 角 波 的 各 个 参数 ， 并 
立即 看 到 其 FFT 频 谱 的 变化 。 


# -*- coding: utf-8 -*- 
from enthought.traits.api import \ 


Str, Float, HasTraits, Property, cached_property, Range, Instar 


from enthought.chaco.api import Plot, AbstractPlotData, ArrayPlotDé 


from enthought.traits.ui.api import \ 


Item, View, VGroup, HSplit, ScrubberEditor, VSplit 


from enthought.enable.api import Component, ComponentEditor 
from enthought.chaco.tools.api import PanTool, ZoomTool 


import numpy as np 


# 鼠标 拖 动 修改 值 的 控件 的 样式 
scrubber = ScrubberEditor ( 


) 


hover_color = OXFFFFFF, 
active_color = OxAOCD9E, 
border_color = 0x808080 


# 取 FFT 计 算 的 结果 freqs 中 的 前 n 项 进行 合成 ， 返 回合 成 结果 ， 计 算 1oops 个 周期 的 波形 
def fft_combine(freqs, n, loops=1): 


length = len(freqs) * loops 
data = np.zeros(length) 
index = loops * np.arange(0, length, 1.0) / length * (2 * np.p: 
for k, p in enumerate(freqs[:n]): 
if k != 0: p *= 2 # 除去 直流 成 分 之 外 ， 其 余 的 系数 都 *2 
data += np.real(p) * np.cos(k*index) # 余弦 成 分 的 系数 为 实数 部 
data -= np.imag(p) * np.sin(k*index) # 正弦 成 分 的 系数 为 负 的 虚 妆 
return index, data 


class TriangleWave(HasTraits): 


# 指定 三 角 波 的 最 窄 和 最 宽 范围 ， 由 于 Range 似 乎 不 能 将 常数 和 traits 名 混用 
# 所 以 定义 这 两 个 不 变 的 trait 属 性 

low = Float(0.02) 

hi = Float(1.0) 


# 三 角 波 形 的 宽度 
wave_width = Range("low", "hi", 0.5) 


# 三 角 波 的 顶点 C 的 X 轴 坐标 
length_c = Range("low", "wave_width", 0.5) 


# 三 角 波 的 定点 的 y 轴 坐标 
height_c = Float(1.0) 


# FFT 计 算 所 使 用 的 取样 点 数 ， 这 里 用 一 个 Enum 类 型 的 属性 以 供用 户 从 列表 中 选择 
fftsize = Enum( [(2**x) for x in range(6, 12)]) 


# FFT 频 谱 图 的 X 轴 上 限 值 
fft_graph_up_ limit = Range(0, 400, 20) 


# 用 于 显示 FFT 的 结 
peak_list = Str 


# 采用 多 少 个 频率 合成 三 角 波 
N = Range(1, 40, 4) 


# 保存 绘图 数据 的 对 象 
plot_data = Instance(AbstractPlotData) 


# 绘制 波形 图 的 容器 


plot_wave = Instance(Component ) 


# 绘制 FFT 频 谱 图 的 容器 
plot_fft = Instance(Component) 


# 包括 两 个 绘图 的 容器 
container = Instance(Component) 


# 设置 用 户 界面 的 视图 ， 注意 一 定 要 指定 窗口 的 大 小 ， 这 样 绘图 容器 才能 正常 初始 人 


view = View( 
HSplit( 
VSplit ( 
VGroup ( 


Item("wave_width", editor = scrubber, label=u"} 


Item("length_c", editor = scrubber, label=u" 最 
Item("height_c", editor = scrubber, label=u"m& 


/ 
[E 


i 


Item("fft_graph_up_limit", editor = scrubber, - 


Item("fftsize", label=u"FFTRR"), 
Item("N", Labe1=u" 合 成 波 频 率 数 " ) 
Ni 


Item("peak_list", style="custom", show_label=False, 


), 
VGroup( 


Item("container", editor=ComponentEditor(size=(600, 


orientation = "vertical" 


) 
), 
resizable = True, 
width = 800, 
height = 600, 
title = u" 三 角 波 FFT 演 示 " 


) 


# UABHAIR, AEREA AARS MUA, Alt seh: 
# 减少 重复 代码 
def _create_plot(self, data, name, type="line"): 
p = Plot(self.plot_data) 
p.plot(data, name=name, title=name, type=type) 
p.tools.append(PanTool(p) ) 
zoom = ZoomTool(component=p, tool_mode="box", always_on=Fa- 
p.overlays.append( zoom) 
p.title = name 
return p 


def _init_ (self): 
# 首先 需要 调用 父 类 的 初始 化 函数 
super(Trianglewave, self).__init__() 


H 创建 绘图 数据 集 ， 暂 时 没有 数据 因此 都 赋值 为 空 ， 只 是 创建 几 个 名 字 ， 以 供 P: 
self.plot_data = ArrayPlotData(x=[], y=[], f=[], p=[], x2=| 


# 创建 一 个 垂直 排列 的 绘图 容器 ， 它 将 频谱 图 和 波形 图 上 下 排列 
self.container = VPlotContainer() 


# 创建 波形 图 ， 波 形 图 绘制 两 条 曲线 : 原始 波形 (x, y ) 和 合成 波形 (x2, y2) 
self.plot_wave = self. create plot(("x","y"), "Triangle Wan' 
self.plot_wave.plot(("x2","y2"), color="red") 


# 创建 频谱 图 ， 使 用 数据 集中 的 f 和 pp 
self.plot_fft = self._create_plot(("f","p"), "FFT", type=' 


# 将 两 个 绘图 容器 添加 到 垂直 容器 中 
self.container.add( self.plot_wave ) 
self.container.add( self.plot_fft ) 


# 设置 

self.plot_wave.x_axis.title = "Samples" 
self.plot_fft.x_axis.title = "Frequency pins" 
self .plot_fft.y_axis.title = "(dB)" 
# 改变 fftsize 为 1024， 因 为 Enum 的 默认 缺 省 值 为 枚 举 列表 中 的 第 一 个 值 
self.fftsize = 1024 


# FFT% A Axi ERAAN SBR, SRN aay it A AS a a R lE 
def _fft_graph_up_limit_changed(self): 
self.plot_fft.x_axis.mapper.range.high = self.fft_graph_up_ 


def _N _changed(self): 
self .plot_sin_combine() 


# SttraiteennksS4xreweisllast, ALAR@on_trait_changeif 
@on_trait_change("wave_width, length_c, height_c, fftsize") 
def update _plot(self): 

# 计算 三 角 波 


global y_data 

x_data = np.arange(0, 1.0, 1.0/self.fftsize) 
func = self.triangle_func() 

# func HAARE ah 4 RAKE Loat64 

y_data = np.cast["float64"](func(x_data) ) 


# 计算 频谱 
fft_parameters = np.fft.fft(y_data) / len(y_data) 


# 计算 各 个 频率 的 振幅 
fft_data = np.clip(20*np.1logi0(np.abs(fft_parameters) )[:se- 


# 将 计算 的 结果 写 进 数据 集 

self.plot_data.set_data("x", np.arange(0, self.fftsize)) # 
self.plot_data.set_data("y", y_data) 
self.plot_data.set_data("f", np.arange(0, len(fft_data))) ? 
self.plot_data.set_data("p", fft_data) 


# 合成 波 的 x 坐 标 为 取样 点 ， 显 示 2 个 周期 
self .plot_data.set_data("x2", np.arange(0, 2*self.fftsize) 


# 更 新 频谱 图 X 轴 上 限 
self._fft_graph_up_limit_changed() 


# 将 振幅 大 于 -80dB 的 频率 输出 

peak_index = (fft_data > -80) 

peak_value = fft_data[peak_index][:20] 

result = [] 

for f, v in zip(np.flatnonzero(peak_index), peak_value): 
result.append("%s : %s" %(f, v) ) 

self.peak_list = "\n".join(result ) 


# 保存 现在 的 fft 计 算 结果 ， 并 计算 正弦 合成 波 
self.fft_parameters = fft_parameters 
self .plot_sin_combine( ) 


# 计算 正弦 合成 波 ， 计 算 2 个 周期 

def plot_sin_combine(self): 
index, data = fft_combine(self.fft_parameters, self.N, 2) 
self.plot_data.set_data("y2", data) 


# 返回 一 个 ufunc 计 算 指 定 参 数 的 三 角 波 
def triangle_func(self): 
c = self.wave_width 
self .length_c 
self .height_c 


def trifunc(x): 


x = x - int(x) # 三角 波 的 周期 为 1， 因 此 只 取 x 坐 标的 小 数 部 分 进行 ; 
if x >=c: r = 0.0 

elif x < cO: r = x / cO * he 

else: r = (c-x) / (c-cO) * he 


return r 


# AtrifuncWRel]e—Tufunche, PHBH uT, Feed! 
# 计算 得 到 的 是 一 个 0bject 数 组， 需要 进行 类 型 转换 
return np.frompyfunc(trifunc, 1, 1) 


if _name__ == "__main_": 
triangle = TriangleWave( ) 
triangle.configure_traits() 








在 traitsUl 中 使 用 的 matplotlib 控 件 


相关 文档 : 设计 自己 的 Trait 编 辑 器 
在 traitsUl 所 产生 的 界面 中 做 入 matplotlib 的 控件 。 
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# -*- coding: utf-8 -*- 

# file name: mpl_figure_editor.py 

import wx 

import matplotlib 

# matplot1lib 采 用 WXAgg 为 后 台 ， 这 样 才能 将 绘图 控件 谨 入 以 wx 为 后 台 界面 库 的 traits 
matplotlib.use( "WXAgg") 

from matplotlib.backends.backend_wxagg import FigureCanvaswWxAgg as 
from matplotlib.backends.backend_wx import NavigationToolbar2wx 
from enthought.traits.ui.wx.editor import Editor 

from enthought.traits.ui.basic_editor_factory import BasicEditorFac 


class _MPLFigureEditor(Editor): 


相当 于 wx 后 台 界 面 库 中 的 编辑 器 ， 它 负责 创建 真正 的 控件 


scrollable = True 


def init(self, parent): 
self.control = self._create_canvas(parent ) 
self.set_tooltip() 
print dir(self.item) 


def update_editor(self): 
pass 


def _create_canvas(self, parent): 
4)3—TPanel, 布局 采用 垂直 排列 的 BoxSizer， pane1 中 中 添加 
FigureCcanvas，NavigationToolbar2Wx，StaticText 三 个 控件 
FigureCanvas 的 鼠标 移动 事件 调用 mousemoved 豆 数 ， 在 StaticText 
显示 鼠标 所 在 的 数据 坐标 


panel = wx.Panel(parent, -1, style=wx.CLIP_CHILDREN ) 
def mousemoved(event ): 

panel.info.SetLabel("%s, %s" % (event.xdata, event. ydat 
panel.mousemoved = mousemoved 
sizer = wx.BoxSizer(wx.VERTICAL) 
panel.SetSizer(sizer ) 
mpl_control = FigureCanvas(panel, -1, self.value) 
mpl_control.mpl_connect("motion_notify_event", mousemoved) 
toolbar = NavigationToolbar2wWx(mpl_ control) 
sizer.Add(mpl_control, 1, wx.LEFT | wx.TOP | wx.GROW) 
sizer.Add(toolbar, 0, wx.EXPAND|wx.RIGHT) 
panel.info = wx.StaticText(parent, -1) 
sizer .Add(panel.info) 


self .value.canvas.SetMinSize((10,10) ) 
return panel 


class MPLFigureEditor(BasicEditorFactory): 


相当 于 traits .ui 中 的 EditorFactory， 它 返回 真正 创建 控件 的 类 


klass = _MPLFigureEditor 


if _name_ == " main_": 
from matplotlib.figure import Figure 
from enthought.traits.api import HasTraits, Instance 
from enthought.traits.ui.api import View, Item 
from numpy import sin, cos, linspace, pi 


class Test(HasTraits): 

figure = Instance(Figure, ()) 

view = View( 
Item("figure", editor=MPLFigureEditor(), show_label=Fa- 
width = 400, 
height = 300, 
resizable = True) 

def _ init__(self): 
super(Test, self).__init_ () 
axes = self.figure.add_subplot(111) 
t = linspace(0, 2*pi, 200) 
axes.plot(sin(t) ) 


Test().configure_traits() 


EE 





FA Python 做 科学 计算 


CSV 文 件数 据 图 形 化 工具 


相关 文档 : 设计 自己 的 Trait 编 辑 器 
采用 在 traitsUI/ 中 使 用 的 matplotlib 控 件 制作 的 CSV 文 件数 据 绘图 工具 。 
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# -*- coding: utf-8 -*- 

from matplotlib.figure import Figure 

from mpl_figure_editor import MPLFigureEditor 
from enthought.traits.ui.api import * 

from enthought.traits.api import * 

import csv 


CSV 文 件数 据 图 形 化 工具 336 


class DataSource(HasTraits): 
数据 源 ，data 是 一 个 字典 ， 将 字符 串 映 射 到 列表 
names 是 data 中 的 所 有 字符 串 的 列表 
data = DictStrAny 
names = List(Str) 


def load_csv(self, filename): 


从 CSV 文 件 读 和 数据， 更 新 data 和 names 属 性 

f = file(filename) 

reader = csv.DictReader(f) 

self.names = reader. fieldnames 

for field in reader. fieldnames: 
self.data[field] = [] 

for line in reader: 
for k, v in line.iteritems(): 

self .data[k].append(float(v)) 
f.close() 


class Graph(HasTraits): 


绘图 组 件 ， 包 括 左边 的 数据 选择 控件 和 右边 的 绘图 控件 
name = Str # 绘图 名 ， 显 示 在 标签 页 标题 和 绘图 标题 中 
data_source = Instance(DataSource) # 保存 数据 的 数据 源 
figure = Instance(Figure) # 控制 绘图 控件 的 Figure 对 象 
selected_xaxis = Str # X 轴 所 用 的 数据 名 
selected_items = List # Y 轴 所 用 的 数据 列表 


clear_button = Button(u" 清 除 ") # 快速 清除 Y 轴 的 所 有 选择 的 数据 


view = View( 
HSplit( # HSplit 分 为 左右 两 个 区 域 ， 中 间 有 可 调节 宽度 比例 的 调节 手柄 
# 左边 为 一 个 组 
VGroup( 
Item("name"), # 绘图 名 编辑 框 
Item("clear_button"), # 清除 按钮 
Heading(u"X 轴 数据 ")， # 静态 文本 
H X 轴 选择 器 ， 用 EnumEditor 编 辑 器 ， 即 ComboBox 控 件 ， 控 件 中 忆 
# data_source 的 names 属 性 得 到 
Item("selected xaxis", editor= 
EnumEditor(name="object.data source.names", fol 
Heading(u"Y 轴 数据 ")，# 静态 文本 
H Y 轴 选择 器 ， 由 于 Y 轴 可 以 多 选 ， 因 此 用 CheckBox 列 表 编 辑 ， 按 两 
Item("selected items", style="custom", 
editor=CheckListEditor(name="object.data sour‘ 
cols=2, format_str=u"%s")), 
show_border = True, # 显示 组 的 边框 
scrollable = True, # 组 中 的 控件 过 多 时 ， 采 用 滚动 条 


show_labels = False # 组 中 的 所 有 控件 都 不 显示 标签 


), 
# 右边 绘图 控件 
Item("figure", editor=MPLFigureEditor(), show_label=Fa- 


) 


def _name_changed(self): 


当 绘图 名 发 生变 化 时 ， 更 新 绘图 的 标题 
axe = self.figure.axes[0] 
axe.set_title(self.name) 
self .figure.canvas.draw() 


def _clear_button_fired(self): 


清除 按钮 的 事件 义理 
self.selected_items = [] 
self.update() 


def _figure_default(self): 


figure 属 性 的 缺 省 值 ， 直 接 创建 一 个 Figure 对 象 
figure = Figure() 
figure.add_axes([0.05, 0.1, 0.9, 0.85]) # 添 加 绘图 区 域 ， 四 周 留 
return figure 


def _selected_items_changed(self): 


Y 轴 数据 选择 更 新 


self .update() 


def _selected_xaxis_changed(self): 


X 轴 数据 选择 更 新 


self .update() 


def update(self): 


重新 绘制 所 有 的 曲线 
axe = self.figure.axes[0] 
axe.clear() 
try: 
xdata = self.data_source.data[self.selected_xaxis] 
except: 
return 
for field in self.selected_items: 


axe.plot(xdata, self.data_source.data[field], label=fie 
axe.set_xlabel(self.selected_xaxis) 
axe.set_title(self.name) 
axe. legend() 
self .figure.canvas.draw() 


class CSVGrapher(HasTraits): 


主 界面 包括 绘图 列表 ， 数 据 源 ， 文 件 选择 器 和 添加 绘图 按钮 
graph_list = List(Instance(Graph)) # 绘图 列表 
data_source = Instance(DataSource) # 数据 源 
csv_file_name = File(filter= a csv"]) # 文件 选择 
add_graph_button = Button(u" 添 加 绘图 ") # 添加 绘图 按钮 


View = View( 
# 整个 窗口 分 为 上 下 两 个 部 分 
VGroup( 
# 上 部 分 横向 放置 控件 ， 因 此 用 HGroup 
HGroup( 
# 文件 选择 控件 
Item("csv_file_name"，1abe1=u" 选 择 CSV 文 件 "，width=46 
# 添加 绘 图 按钮 
See er een show_label=False) 
), 
# 下 部 分 是 绘图 列表 ， 采 用 ListEditor 编 辑 器 显示 
Item("graph_list", style="custom", show_label=False, 
editor=ListEditor ( 
use_notebook=True, # 是 用 多 标签 页 格式 显示 
deletable=True, # 可 以 删除 标签 页 
dock_style="tab", # 标签 dock 样 式 
page_name=".name") # 标题 页 的 文本 使 用 Graph 对 象 的 n 


) ， 


resizable = True, 
height = ie 8, 

width .8, 

title "CSV 数 据 绘图 器 " 


) 


def _csv_file_name_changed(self): 


打开 新 文件 时 的 处 理 ， 根 据 文件 创建 一 个 DataSource 





self.data_source = DataSource() 
self .data_source.load_csv(self.csv_file_name) 
del self.graph_list[:] 


def _add_graph_button_changed(self): 


添加 绘 图 按钮 的 事件 义理 


if self.data_source != None: 


self.graph_list.append( Graph(data_source = self.data_: 
if _name__ == "__main_": 
csv_grapher = CSVGrapher() 
csv_grapher.configure_traits() 








NLMS 算 法 的 模拟 测试 


相关 文档 : 自 适应 滤波 器 和 NLMS 模 拟 
测试 NLMS 在 系统 辨识 、 信 号 预测 和 信号 均衡 方面 的 应 用 。 


# 


-*- Coding: utf-8 -*- 


# filename: nlms_test.py 


import numpy as np 
import pylab as pl 
import nlms_numpy 

import scipy.signal 


# 随机 产生 FIR 滤 波 器 的 系数 ， 长 度 为 length， 延 时 为 delay， 指数 衰减 
def make_path(delay, length): 


path_length = length - delay 

h = np.zeros(length, np.float64) 

h[delay:] = np.random.standard_normal(path_length) * np.exp( np 
h /= np.sqrt(np.sum(h*h) ) 


return h 


def plot_converge(y, u, label=""): 


size = len(u) 

avg_number = 200 

e = np.power(y[:size] - u, 2) 

tmp = e[:int(size/avg_number )*avg_number ] 

tmp.shape = -1, avg_number 

avg = np.average( tmp, axis=1 ) 

pl.plot(np.linspace(0, size, len(avg)), 10*np.logi0(avg), linev 


def diff_db(ho, h): 


return 10*np.logi0(np.sum((hO-h)*(hO-h)) 7 np.sum(h0*hO) ) 


# 用 NLMS 进 行 系统 辨识 的 模拟 ， RAURA ERMA, 使 用 的 参照 信号 为 X 
def sim_system_identify(nlms, x, hO, step_size, noise_scale): 


y = np.convolve(x, h0) 

d = y + np.random.standard_normal(len(y)) * noise scale # XN) 
h = np.zeros(len(h0), np.float64) # 自 适 应 滤波 器 的 长 度 和 未 知 系统 
u = nims( x, d, h, step_size ) 


return y, u, h 


def system_identify_test1(): 


ho = make_path(32, 256) # BE > E—-FRARAN HBR 

x = np.random.standard_normal(10000) # 参照 信号 为 白 噪 声 

y, u, h = sim_system_identify(nlms_numpy.nims, x, hO, 0.5, 0.1° 
print diff_db(hO, h) 

pl.figure( figsize=(8, 6) ) 

pl.subplot(211) 


pl.subplots_adjust(hspace=0. 4) 
pl.plot(h0, c="r") 

pl.plot(h, c="b") 

pl1.title(u" 未 知 系统 和 收 仇 后 的 滤波 器 的 系数 比较 " ) 
pl.subplot( 212) 

plot_converge(y, u) 

pl.title(u" 自 适应 滤波 器 收敛 特性 ") 
pl.xlabel("Iterations (samples)") 
pl.ylabel("Converge Level (dB)") 
pl.show( ) 


def system_identify_test2(): 
hO = make_path(32, 256) # 随机 产生 一 个 未 知 系 统 的 传递 函数 
x = np.random.standard_normal(20000) # 参照 信号 为 白 噪声 
pl.figure(figsize=(8,4)) 
for step_size in np.arange(@0.1, 1.0, 0.2): 
y, u, h = sim_system_identify(nlms_numpy.nlms, x, hO, step_ 
plot_converge(y, u, label=u"y=%s" % step_size) 
pl.title(u" 更 新 系数 和 收敛 特性 的 关系 ") 
pl.xlabel("Iterations (samples)") 
pl.ylabel("Converge Level (dB)") 
pl.legend() 
pl.show( ) 


def system_identify_test3(): 

hO = make_path(32, 256) # 随机 产生 一 个 未 知 系 统 的 传递 函数 

x = np.random.standard_normal(20000) # 参照 信号 为 白 噪声 

pl.figure(figsize=(8,4)) 

for noise_scale in [0.05, 0.1, 0.2, 0.4, 0.8]: 
y, u, h = sim_system_identify(nlms_numpy.nlms, x, ho, 0.5, 
plot_converge(y, u, label=u"noise=%s" % noise_scale) 

pl.title(u" 外 部 干扰 和 收敛 特性 的 关系 ") 

pl.xlabel("Iterations (samples)") 

pl.ylabel("Converge Level (dB)") 

pl.legend() 


pl.show( ) 
def sim_signal_equation(nlms, x, hO, D, step_size, noise_scale): 

= x[:-D] 

x = x[D:] 

y = np.convolve(x, h0O)[:len(x)] 

h = np.zeros(2*len(h0)+2*D, np.float64) 

y += np.random.standard_normal(len(y)) * noise_scale 

u = nims(y, d, h, step_size) 

return h 


def signal_equation_test1(): 
ho = make_path(5, 64) 
D = 128 
length = 20000 
data = np.random.standard_normal(length+D) 
h = sim_signal_equation(nlms_numpy.nlms, data, hO, D, 0.5, 0.1 
pl.figure(figsize=(8,4)) 


pl.plot(ho, label=u"AWMA") 

pl.plot(h, label=u" B38 % 38325" ) 
pl.plot(np.convolve(h0, h), label=u"—###R") 
pl.title(u" 信 号 均衡 演示 ") 

pl.legend() 

w0, HO = scipy.signal.freqz(h0, worN = 1000) 
w, H = scipy.signal.freqz(h, worN = 1000) 
pl.figure(figsize=(8,4)) 

pl.plot(w0, 20*np.log10(np.abs(HO)), w, 20*np.1logi0(np.abs(H))_ 
pl1.tit1le(u" 未 知 系统 和 自 适 应 滤波 器 的 振幅 特性 " ) 
pl.xlabel(u" 圆 频率 ") 

pl.ylabel(u" 振 幅 (dB)") 

pl. show() 


signal equation_ test1() 
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FA Python 做 科学 计算 


三 维 标量 场 观察 器 


相关 文档 : 将 Mayav/j 绪 入 到 界面 中 


‘e 三 维 标 量 场 观察 香 
x0:[-5 
ls O ë | 
Yo:[-5 
ls | 
zo:|-5 0 
Bs | 

点 数 : | 50 


自动 等 值 : M 


oe a 
impo 
from 


from 
from 
from 
from 
from 


clas 


描画 | 


[x*y*0.5 + sin(2*x)*y + y*z*2.0 
4.92 ' if Li ' ' i 1 1 ' ' t 64.92 0.50 





- coding: utf-8 -*- 
rt numpy as np 
numpy import * 


enthought.traits.api import * 

enthought.traits.ui.api import * 
enthought.tvtk.pyface.scene_editor import SceneEditor 
enthought.mayavi.tools.mlab_scene_model import MlabSceneModel 
enthought.mayavi.core.ui.mayavi_scene import MayaviScene 


s FieldViewer(HasTraits): 
Ww "三 维 标量 场 观察 器 " "N 


# 三 个 轴 的 取 值 范围 


x0, x1 = Float(-5), Float(5) 
yO, y1 = Float(-5), Float(5) 
z0, zi = Float(-5), Float(5) 
points = Int(50) # 分 割 点 数 


autocontour = Bool(True) # 是 否 自动 计算 等 值 面 

vO, vi = Float(0.0), Float(1.0) # 等 值 面 的 取 值 范围 
contour = Range("vo", "vi", 0.5) # 等 值 面 的 值 
function = Str("x*x*0.5 + y*y + z*z*2.0") # 标量 场 函 数 
plotbutton = Button(u" 描 画 ") 

scene = Instance(MlabSceneModel, ()) # mayavi 场 景 
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view = View( 
HSplit( 
VGroup( 

nes ap a) Rie "yo", PNIL zour sir os ae 

Item('points', label=u" 4"), 

Item('autocontour'，1label=u" 自 动 等 值 ")， 

Item('plotbutton', show_label=False), 

), 
VGroup ( 

Item(name='scene', 
editor=SceneEditor(scene_class=MayaviScene), # 
resizable=True, 
height=300, 
width=350 

)， function ' ， 

Item('contour', 
editor=RangeEditor(format="%1.2f", 

low_name="v0", high_name="vi" ) 

), show_labels=False 


) 
); 
width = 500，resizable=True，title=u" 三 维 标量 场 观察 器 " 


def _plotbutton_fired(self): 
self.plot() 


def _autocontour_changed(self): 
"自动 计算 等 值 平面 的 设置 改变 事件 响应 " 
if hasattr(self, "g"): 
self.g.contour.auto_contours = self.autocontour 
if not self.autocontour: 
self. _contour_changed() 


def _contour_changed(self): 
"等 值 平面 的 值 改变 事件 响应 " 
if hasattr(self, "g"): 
if not self.g.contour.auto_contours: 
self.g.contour.contours = [self.contour ] 


def plot(self): 

"绘制 场景 " 

# 产生 三 维 网 格 

xX, y, Z = mgrid[ 
self .x0:self.x1:1j*self.points, 
self.yO:self.y1:1j*self.points, 
self .z0:self.z1:1j*self.points] 

scalars = eval(self.function) # 根据 画 数 计算 标量 场 的 值 

self.scene.mlab.clf() # 清空 当前 场景 


# 绘制 等 值 平面 
g = self.scene.mlab.contour3d(x, y, z, scalars, contours=8, 
g.contour.auto_contours = self.autocontour 


self.scene.mlab.axes() # 添加 坐标 轴 


# 添加 一 个 X-Y 的 切面 

s = self.scene.mlab.pipeline.scalar_cut_plane(g) 

cutpoint = (self.x0+self.x1)/2, (self.yO+self.y1)/2, (self 
s.implicit_plane.normal = (0,0,1) # x cut 
s.implicit_plane.origin = cutpoint 
self.g = g 

self.scalars = scalars 

# 计算 标量 场 的 值 的 范围 
self.vO = np.min(scalars) 
self.vi = np.max(scalars) 


app = FieldViewer() 
app.configure_traits() 





频谱 港 漏 和 hann 窗 


相关 文档 : 频 域 信号 处 理 


对 于 8kHz 取 样 频 率 的 200Hz 300Hz 的 又 加 波形 进行 512 点 FFT 计 算 其 频谱 ， 上 比较 算 
形 窗 和 hann 窗 的 频谱 HS. 


# -*- coding: utf-8 -*- 

# 用 hann 窗 降低 频谱 泄漏 

# 

import numpy as np 

import pylab as pl 

import scipy.signal as signal 


sampling_rate = 8000 
fft_size = 512 
t = np.arange(0, 1.0, 1.0/sampling_rate) 


x 
od 


np.sin(2*np.pi*200*t) + 2*np.sin(2*np.pi*300*t) 
xs = x[:fft_size] 
ys = xs * signal.hann(fft_size, sym=0) 


xf = np.fft.rfft(xs)/fft_size 

yf = np.fft.rfft(ys)/fft_size 

freqs = np.linspace(0, sampling_rate/2, fft_size/2+1) 
xfp = 20*np.logiO0(np.clip(np.abs(xf), 1e-20, 1¢100) ) 
yfp = 20*np.logi0(np.clip(np.abs(yf), 1e-20, 1e100) ) 
pl.figure(figsize=(8,4)) 
pl.title(u"200Hz 和 300Hz 的 波形 和 频谱 ") 

pl.plot(freqs, xfp, label=u" EHH") 

pl.plot(freqs, yfp, label=u"hann 窗 ") 

pl.legend() 

pl.xlabel(u" 频 率 (Hz)") 


a = pl.axes([.4, .2, .4, .4]) 
a.plot(freqs，xfp，1abe1=u" 和 矩形 窗 " ) 
a.plot(freqs, yfp,，1label=u"hann 窗 ") 
a.set_xlim(100, 400) 
a.set_ylim(-40, 0) 

pl.show( ) 


FFT 4342 BRE kbi 


相关 文档 : 频 域 信号 处 理 


直接 众 积 的 复杂 度 为 OINN)，FFT 的 复杂 度 为 O(Mog(N))， 此 程序 分 别 计 算 直 接 郑 
积 和 快速 众 积 的 耗 时 曲线 。 请 注意 Y 轴 为 每 点 的 平均 运算 时 间 。 


卷 积 的 计算 时 间 


© © © 四 © © 
© © © © © © 
© © = = = pp 
a 0 © N A fon) 


计算 时 间 (ms/point) 


8.804 





19090 2000 3000 4000 5000 6000 7000 89000 


长 度 


# -*- coding: utf-8 -*- 
import numpy as np 
import timeit 

def fft_convolve(a,b): 


n = len(a)+len(b)-1 
N = 2**(int(np.log2(n))+1) 
A = np.fft.fft(a, N) 
B = np.fft.fft(b, N) 


return np.fft.ifft(A*B)[:n] 


if _name__ == "__main_": 
from pylab import * 
n_list = [] 
ale liste} eee] 
t2mast =i] 
for n in xrange(4, 14): 
N = 2**n 


count = 10000**2 / N**2 
if count > 10000: count = 10000 
setup = wun 
import numpy as np 
from _main__ import fft_convolve 
a = np.random.rand(%s ) 
b = np.random.rand(%s) 
"nN % (N, N) 
t1 = timeit.timeit("np.convolve(a,b)", setup, number=count' 
t2 = timeit.timeit("fft_convolve(a,b)", setup, number=count 
t1_list.append(t1*1000/count/N) 
t2_list.append(t2*1000/count/N) 
n_list.append(N) 
figure(figsize=(8, 4) ) 
plot(n_list, ti_list, label=u"B##@R") 
plot(n_list, t2_list, label=u"FFT##") 
legend() 
title(u" 疮 积 的 计算 时 间 ") 
ylabel(u" 计 算 时 间 (ms/point)") 
xlabel(u" KE") 
xlim(min(n_list),max(n_list) ) 
show( ) 





二 次 均衡 器 设计 
相关 文档 : 数字 信号 系统 


用 Traits.UI 和 Chaco 制 作 的 二 次 均衡 器 的 设计 工具 ， 用 户 可 以 任意 添加 二 次 滤波 
器 ， 并 且 调 整 其 中 心 频率 、 增 益 和 Q 值 ， 并 即时 查看 组 合 之 后 的 最 终 频 率 响应 。 
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# -*- coding: utf-8 -*- 
import math 

from enthought. 
from enthought. 


traits.api import Float, HasTraits, List, Array, on. 
traits.ui.api import View, TableEditor, Item, Group, 
from 





from 
from 
from 
from 


enthought. 
enthought. 
enthought. 
enthought. 
enthought. 


import pickle 
import numpy as np 


SAMPLING_RATE 
1000 # 频率 响应 曲线 的 点 数 


WORN 


# 对 数 圆 频率 数组 


W 


np.logspace(np.1log10(10/SAMPLING_RATE*np.pi), 


# 对 数 频 率 数组 
FREQS = W / 2 / np.pi * SAMPLING_RATE 


traits.ui.table_column import ObjectColumn 
chaco.api import Plot, AbstractPlotData, ArrayPlotDé 
chaco.tools.api import PanTool, ZoomTool 

enable.api import Component, ComponentEditor 
pyface.api import FileDialog, OK 


44100.0 # 取样 频率 


np.log10(np.pi), 


# 候选 频率 

EQ_FREQS = [20.0,25.2,31.7,40.0,50.4,63.5,80.0,100.8, 
127.0,160.0, 201.6, 254.0, 320.0, 403.2,508.0, 640.0, 
806.3,1015.9,1280.0, 1612.7, 2031.9, 2560.0, 3225.4, 
4063.7, 5120.0, 6450.8, 8127.5, 10240.0,12901.6, 
16255.0, 20480.0, ] 


def scrubber(inc): 
5 创建 不 同 增 量 的 ScrubberEditor' 
return ScrubberEditor ( 
hover_color = OXxFFFFFF, 
active_color OxAOCD9E, 
border_color = Ox808080, 
increment = inc 


) 


def myfreqz(b, a, w): 
' 计算 滤波 器 在 w 个 点 的 频率 响应 ' '， 
zmi = np.exp(-1j*w) 
h = np.polyval(b[::-1], zm1) / np.polyval(a[::-1], zm1) 
return h 


def design_equalizer(freg, Q, gain, Fs): 
' 设计 二 次 均衡 滤波 器 的 系数 '， 
A = 10**(gain/40.0) 
wo = 2*math.pi*freq/Fs 
alpha = math.sin(w0) / 2 / Q 


bo = 1+ alpha * A 
b1 = -2*math.cos(w0) 
b2 = 1 - alpha * A 
a0 = 1 + alpha / A 
al = -2*math.cos(w0) 
a2 = 1 - alpha / A 


return [b0/a0,b1/a0,b2/a0], [1.0, ai/a0, a2/a0] 


class Equalizer(HasTraits): 
freq = Range(10.0, SAMPLING_RATE/2, 1000) 
Q = Range(0.1, 10.0, 1.0) 
gain = Range(-24.0, 24.0, 0) 


a = List(Float, [1.0,0.0,0.0]) 
b = List(Float, [1.0,0.0,0.0]) 
h = Array(dtype=np.complex, transient = True) 


def _ init (self): 
super (Equalizer, self). init _ () 
self .design_parameter( ) 


@on_trait_change("freq,Q, gain") 


def design_parameter(self): 
'"'' 设 计 系 数 并 计算 频率 响应 ''' 
try: 
self.b, self.a = design _equalizer(self.freg, self.Q, st 
except: 
self.b, self.a = [1.0,0.0,0.0], [1.0,0.0,0.0] 
self.h = myfreqz(self.b, self.a, W) 


def export_parameters(self, f): 
1" ETH 78 Ras Re Cis Shee | '' 
tmp = self.b[0], self.b[1], self.b[2], self.a[1], self.a[2_ 
f.write("{%s,%S,%S,%S,%S}, // %S,%S,%S\n" % tmp) 


class Equalizers(HasTraits): 
eqs = List(Equalizer, [Equalizer()]) 
h = Array(dtype=np.complex, transient = True) 


# Equalizer 列 表 eqs 的 编辑 器 定义 
table editor = TableEditor( 
columns = [ 
ObjectColumn(name="fFreq", width=0.4, style="readonly"), 
ObjectColumn(name="Q", width=0.3, style="readonly"), 
ObjectColumn(name="gain", width=0.3, style="readonly"), 
], 
deletable = True, 
sortable = True, 
auto_size = False, 
show_toolbar = True, 
edit_on_first_click = False, 


orientation = 'vertical', 
edit_view = View( 
Group ( 


Item("fregq", editor=EnumEditor(values=EQ FREQS)), 
Item("freg", editor=scrubber(1.0)), 
Item("Q", editor=scrubber(0.01)), 
Item("gain", editor=scrubber(0.1)), 
show_border=True, 

), 

resizable = True 

), 


row_factory = Equalizer 


) 


view = View( 
Item("eqs", show_label=False, editor=table editor), 


width = 0.25, 
height = 0.5, 
resizable = True 


) 


@on_trait_change("eqs.h") 
def recalculate_h(self): 
''' 计 算 多 组 均衡 器 级 联 时 的 频率 响应 '" 


try: 


tmp = np.array([eq.h for eq in self.eqs if eq.h != None 


self.h = np.prod(tmp, axis=0) 
except: 
pass 


def export(self, path): 
'" "将 均衡 器 的 系数 输出 为 C 语 言 文件 ' 
f = file(path, "w") 
f.write("double EQ PARS[][5] = {\n") 
f.write("//b0,b1,b2,a0,a1 // frequency, Q, gain\n") 
for eq in self.eqs: 
eq.export_parameters(f) 
f .write("};\n") 
f.close() 


class EqualizerDesigner(HasTraits): 


' 均衡 器 设计 器 的 主 界面 ' '， 
equalizers = Instance(Equalizers) 


# 保存 绘图 数据 的 对 象 
plot_data = Instance(AbstractPlotData) 


# 绘制 波形 图 的 容器 


container = Instance(Component ) 


plot_gain = Instance(Component ) 
plot_phase = Instance(Component ) 
save_button = Button("Save") 
load_button = Button("Load") 
export_button = Button("Export") 


view = View( 
VGroup( 

HGroup( 
Item("load_button"), 
Item("save_button"), 
Item("export_button"), 
show_labels = False 

), 

HSplit ( 

VGroup( 


Item("equalizers", style="custom", show_label=! 


show_border=True, 


) ， 


Item("container", editor=ComponentEditor(size=(800, 


) 
), 
resizable = True, 
width = 800, 
height = 500, 
title = u"Equalizer Designer" 


) 


def _create_plot(self, data, name, type="line"): 
p = Plot(self.plot_data) 
p.plot(data, name=name, title=name, type=type) 
p.tools.append(PanTool(p)) 
zoom = ZoomTool(component=p, tool_mode="box", always_on=Fa- 
p.overlays.append( zoom) 
p.title = name 
p.index_scale = "log" 
return p 


def _ init__(self): 
super (EqualizerDesigner, self). _init_ () 
self.plot_data = ArrayPlotData(f=FREQS, gain=[], phase=[]) 
self.plot_gain = self._create_plot(("f", "gain"), "Gain(dB` 
self.plot_phase = self._create_plot(("f", "phase"), "Phasel 
self.container = VPlotContainer() 
self.container.add( self.plot_phase ) 
self.container.add( self.plot_gain ) 
self.plot_gain.padding bottom = 20 
self.plot_phase.padding_top = 20 


def _equalizers_default(self): 
return Equalizers() 


@on_trait_change("equalizers.h") 

def redraw(self): 
gain = 20*np.log10(np.abs(self.equalizers.h) ) 
phase = np.angle(self.equalizers.h, deg=1) 
self.plot_data.set_data("gain", gain) 
self.plot_data.set_data("phase", phase) 


def _save_button_fired(self): 
dialog = FileDialog(action="Save as", wildcard='EQ files (’ 
result = dialog.open() 
if result == OK: 
f = file(dialog.path, "wb") 
pickle.dump( self.equalizers , f) 
f.close() 


def _load_button_fired(self): 
dialog = FileDialog(action="open", wildcard='EQ files (*.e¢ 
result = dialog.open() 
if result == OK: 
f = file(dialog.path, "rb") 
self.equalizers = pickle.load(f) 
f.close() 


def _export_button_fired(self): 
dialog FileDialog(action="Save as", wildcard='c files (* 
result = dialog.open() 
if result == OK: 


self .equalizers.export(dialog.path) 


win = EqualizerDesigner( ) 
win.configure_traits() 


«| = 








单 摆 摆 动 周期 的 计算 


相关 文档 : 单 摆 和 双 摆 模拟 
本 程序 利用 odeint 和 fsolve 计 算 单 摆 的 摆动 周期 ， 并 且 和 精确 值 进行 比较 。 


长 度 为 1 米 单 摆 : 初始 摆 角 -摆动 周期 


= “fsolve 计 算 的 单 摆 周 期 
一 ” 单 摆 周 期 精确 值 





Sg 8.2 8.4 8.6 8.8 1.0 1.2 1.4 1.6 


初始 摆 角 (弧度 ) 


# -*- coding: utf-8 -*- 

from math import sin, sqrt 

import numpy as np 

from scipy.integrate import odeint 
from scipy.optimize import fsolve 
import pylab as pl 

from scipy.special import ellipk 


Ga= 2928 
def pendulum_equations(w, t, 1): 
th, v=w 
dth =v 
dv = - g/l * sin(th) 


return dth, dv 


def pendulum_th(t, 1, tho): 
track = odeint(pendulum_equations, (th0, 0), [0, t], args=(1,). 
return track[-1, 0] 


def pendulum_period(1l, th0): 
tO = 2*np.pi*sqrt( 1/g ) / 4 
t = fsolve( pendulum_th, tO, args = (1, thO) ) 
return t*4 


ths = np.arange(0, np.pi/2.0, 0.01) 

periods = [pendulum_period(1, th) for th in ths] 

periods2 = 4*sqrt(1.0/g)*ellipk(np.sin(ths/2)**2) # +} %2 AHN 
pl.plot(ths, periods, label = u"fsolve 计 算 的 单 摆 周 期 "，1linewidth=4.0) 
pl.plot(ths, periods2, "r", label = U" 单 摆 周 期 精确 值 "， linewidth=2.0) 
pl.legend(loc='upper left') 

pl.title(u"KEA1K## : 初始 摆 角 - 摆动 周期 " ) 

pl.xlabel(u" 初 始 摆 角 ( 弧 度 )") 

pl.ylabel(u" 摆 动 周期 ( 秒 )") 

pl. show() 





用 Python 做 科学 计算 


双 摆 系统 的 动画 模拟 


相关 文档 : 单 摆 和 双 摆 模拟 


双 摆 系统 的 轨迹 ， 初 始 角度 =8.2,6.4 





用 odeint 解 双 摆 系统 


文件 名 : double_pendulum_odeint.py 


# -*- coding: utf-8 -*- 


双 摆 系统 的 动画 模拟 358 


from math import sin,cos 
import numpy as np 
from scipy.integrate import odeint 


0 8 


class DoublePendulum(object): 
def _ init (self, m1, m2, 11, 12): 


self.mi, self.m2, self.11, self.12 = m1, m2, 11, 12 
self.init_status = np.array([0.0,0.0,0.0,0.0]) 


def equations(self, w, t): 
微分 方程 公式 
mi, m2, 11, 12 = self.m1, self.m2, self.11, 
thi, th2, vi, v2 =w 


dthi = vi 

dth2 = v2 

#eq of thi 

a = 11*11*(mi+m2) # dvi parameter 

b = 11*m2*12*cos(thi-th2) # dv2 paramter 

c = 11*(m2*12*sin(thi-th2)*dth2*dth2 + (mi+m2)*g*sin(th1) ) 
#eq of th2 

d = m2*12*11*cos(thi-th2) # dvi parameter 

e = m2*12*12 # dv2 parameter 

f = m2*12*(-11*sin(th1-th2)*dthi*dthi + g*sin(th2)) 


dvi, dv2 = np.linalg.solve([[a,b],[d,e]], [-c,-f]) 


return np.array([dth1, dth2, dvi, dv2]) 


def double pendulum_odeint(pendulum, ts, te, tstep): 


对 双 摆 系统 的 微分 方程 组 进行 数值 求解 ， 返 回 两 个 小 球 的 X-Y 坐 标 


t = np.arange(ts, te, tstep) 


track = odeint(pendulum.equations, pendulum.init_status, t) 


thi_array, th2_array = track[:,0], track[:, 1] 
11, 12 = pendulum.11, pendulum.12 


x1 = 11*np.sin(thi_array) 
yi = -11*np.cos(th1_array) 
x2 = x1 + 12*np.sin(th2_array) 


y2 = y1 - 12*np.cos(th2_array) 


pendulum.init_status = track[-1,:].copy() #maAhMKAm¢Apendul 


return [xi, y1, x2, y2] 
if _name == "_ main_": 

import matplotlib.pyplot as pl 

pendulum = DoublePendulum(1.0, 2.0, 1.0, 2.0) 

th1，th2 = 1.0, 2.0 


pendulum.init_status[:2] = thi, th2 

x1, yi, x2, y2 = double_pendulum_odeint(pendulum, 0, 30, 0.02) 
pl plot (<4, v1, label = u" 上 球 ") 

pl-plot(x2,y2, label = u" 下 球 ") 

pl.title(u" 双 摆 系 统 的 轨迹 ， 初 始 角 度 =%s,%s" % (th1，th2) ) 
pl.legend() 

pl.axis("equal") 

pl.show( ) 








摆动 动力 


文件 名 : double_pendulum_animation.py 


# -*- coding: utf-8 -*- 

import matplotlib 

matplotlib.use('WxXAgg') # do this before importing pylab 

import matplotlib.pyplot as pl 

from double _pendulum_odeint import double _pendulum_odeint, DoublePe 


linel, pL. plot( [6,0], [0,0], “-o") 
line2, pl.plot([0,0], [0,0], "-o") 
pl.axis("equal") 

pl.xlim(-4,4) 

pl.ylim(-4,2) 


fig = pl.figure(figsize=(4,4)) 


pendulum = DoublePendulum(1.0, 2. 
pendulum.init_status[:] = 1.0, 2. 


x1, y1, x2, y2 = [],[];[],[] 
idx = 0 


def update_line(event): 
global x1, x2, y1, y2, idx 
if idx == len(x1): 
x1, yi, x2, y2 = double_pendulum_odeint(pendulum, 0, 1, 0.( 
idx = 0 
linei.set_xdata([0, x1[idx]]) 
linei.set_ydata([0, y1[idx]]) 
line2.set_xdata([xi[idx], x2[idx]]) 
line2.set_ydata([y1i[idx], y2[idx]]) 
fig.canvas.draw() 
idx += 1 


import wx 

id = wx.NewId() 

actor = fig.canvas.manager.frame 
timer = wx.Timer(actor, id=id) 

timer .Start(1) 

wx.EVT_TIMER(actor, id, update_line) 
pl.show( ) 
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# -*- coding: utf-8 -*- 


import numpy as np 

import pylab as pl 

import time 

from matplotlib import cm 


def iter_point(c): 
Z=C 
for i in xrange(1, 100): # 最 多 迭代 100 次 
if abs(z)>2: break # 半径 大 于 2 则 认为 逃逸 
Z = Z*Z+C 


return i # 返回 迭代 次 数 


def draw_mandelbrot(cx, cy, d): 


绘制 点 (cx，cy ) 附 近 正 负 d 的 范围 的 Mandelbrot 
x0, x1, yO, y1 = cx-d, cx+d, cy-d, cytd 
y, X = np.ogrid[y0:y1:200j, x0:x1:200] | 
c = x + y*1j 
start = time.clock() 
mandelbrot = np.frompyfunc(iter_point,1,1)(c).astype(np.float) 
print "time=",time.clock() - start 
pl.imshow(mandelbrot, cmap=cm.Blues_r, extent=[x0,x1,y0,y1]) 
pl.gca().set_axis_off() 


x,y = 0.27322626, 0.595153338 


pl.subplot(231) 
draw_mandelbrot(-0.5,0,1.5) 
for i in range(2,7): 

pl.subplot(230+i) 

draw_mandelbrot(x, y, 0.2**(i-1)) 
pl.subplots_adjust(0.02, ©, 0.98, 1, 0.02, 0) 
pl.show() 


Aoo 启 "| 


Weave 版 本 


# -*- coding: utf-8 -*- 


import numpy as np 

import pylab as pl 

import time 

import scipy.weave as weave 
from matplotlib import cm 


def weave_iter_point(c): 
code = Wwe 
std: :complex<double> z; 
int i; 
Z = C; 
for (i=1;1<100; i++) 


{ 

if(std::abs(z) > 2) break; 
A S Ze 

} 


return_val=i; 


f = weave.inline(code, ["c"], compiler="gcc") 
return f 


def draw_mandelbrot(cx, cy, d,N=200): 


绘制 点 (cx，cy ) 附 近 正 负 d 的 范围 的 andelbrot 
x0, x1, yO, y1 = cx-d, cx+d, cy-d, cy+d 
y, X = np.ogrid[yO:yi:N*1j, xO:x1i:N*1j] 
c = x + y*1j 
start = time.clock() 
mandelbrot = np.frompyfunc(weave_iter_point,1,1)(c).astype(np.1 
print "time=",time.clock() - start 
pl.imshow(mandelbrot, cmap=cm.Blues_r, extent=[x0, x1, yO, y1]) 
pl.gca().set_axis_off() 


X,Y = 0.27322626, 0.595153338 


pl.subplot (231) 
draw_mandelbrot(-0.5,0,1.5) 
for i in range(2,7): 
pl.subplot(230+71) 
draw_mandelbrot(x, y, 0.2**(i-1)) 
pl.subplots_adjust(0.02, ©, 0.98, 1, 0.02, 0.02) 


pl.show( ) 


«| a. 











NumPy 加 速 版 本 


# -*- coding: utf-8 -*- 


import numpy as np 

import pylab as pl 

import time 

from matplotlib import cm 


def draw_mandelbrot(cx, cy, d, N=200): 


绘制 点 (cx， cy) 附 近 正 负 d 的 范围 的 MandelLbrot 


global mandelbrot 


xO, x1, yO, y1 = cx-d, cxtd, cy-d, cytd 
y, X = np.ogrid[yO:yi:N*1j, x0:x1:N*1j] 
c = x + y*1j 


# 创建 X,Y 轴 的 坐标 数组 
ix, iy = np.mgrid[0:N,0:N] 


# 创建 保存 mandelbrot 图 的 二 维 数 组 ， 缺 省 值 为 最 大 迭代 次 数 
mandelbrot = np.ones(c.shape, dtype=np.int)*100 


# 将 数组 都 变 成 一 维 的 


ix.shape = -1 
iy.shape = -1 
c.shape = -1 


z = c.copy() # 从 c 开 始 迭 代 ， 因 此 开始 的 迭代 次 数 为 1 
start = time.clock() 


for i in xrange(1,100): 
# 进行 一 次 迭代 
z *= Zz 
Z += C 
# 找到 所 有 结果 逃逸 了 的 点 
tmp = np.abs(z) > 2.0 
# 将 这 些 逃 逸 点 的 迭代 次 数 赋值 给 mandeLIbrot 图 
mandelbrot[ix[tmp], iy[tmp]] = i 


# 找到 所 有 没有 逃逸 的 点 

np.logical_not(tmp, tmp) 

# 更 新 ix，iy，c，Zz 只 包含 没有 逃逸 的 点 

ix,iy,c,z = ix[tmp], iy[tmp], c[tmp],z[tmp] 
if len(z) == 0: break 


print "time=",time.clock() - start 
pl.imshow(mandelbrot, cmap=cm.Blues_r, extent=[x0, x1, y0,y1]) 
pl.gca().set_axis_off() 


X,Y = 0.27322626, 0.595153338 


FA Python 做 科学 计算 


pl.subplot(231) 
draw_mandelbrot(-0.5,0,1.5) 
for i in range(2,7): 

pl.subplot (230+) 

draw_mandelbrot(x, y, 0©.2**(i-1)) 
pl.subplots_adjust(0.02, ©, 0.98, 1, 0.02, 0) 
pl.show( ) 


平滑 版 本 
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al 


# -*- coding: utf-8 -*- 


import numpy as np 

import pylab as pl 

from math import log 

from matplotlib import cm 


escape_radius = 10 
iter_num = 20 


def 


def 


def 


smooth_iter_point(c): 
Z = C 
for i in xrange(1, iter_num): 
if abs(z)>escape_radius: break 
Z = z*zt+c 
absz = abs(z) 
if absz > 2.0: 
mu = i - log(log(abs(z),2),2) 
else: 
mu = i 
return mu # 返回 正规 化 的 迭代 次 数 


iter_point(c): 

Z = C 

for i in xrange(1, iter_num): 
if abs(z)>escape_radius: break 
Z = Z*Z+C 

return i 


draw_mandelbrot(cx, cy, d, N=200): 
global mandelbrot 


绘制 点 (cx，cy ) 附 近 正 负 d 的 范围 的 andelbrot 


x0, x1, yO, y1 = cx-d, cx+d, cy-d, cy+d 

y, X = np.ogrid[yO:yi:N*1j, xO:x1i:N*1j] 

C= x + y*1j 

mand = np.frompyfunc(iter_point,1,1)(c).astype(np.float ) 
smooth_mand = np.frompyfunc(smooth_iter_point,1,1)(c).astype(ny 
pl.subplot(121) 

pl.gca().set_axis_off() 

pl.imshow(mand, cmap=cm.Blues_r, extent=[x0, x1, yO, y1]) 
pl.subplot(122) 

pl.imshow(smooth_mand, cmap=cm.Blues_r, extent=[x0, x1, y0,y1]) 
pl.gca().set_axis_off() 


draw_mandelbrot(-0.5,0,1.5,300) 
pl.subplots_adjust(0.02, 0, 0.98, 1, 0.02, 0) 
pl.show( ) 
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相关 文档 : EEK A (IFS) 





# -*- coding: utf-8 -*- 

import numpy as np 

import matplotlib.pyplot as pl 
import time 


H 蕨 类 植物 叶子 的 迭代 函数 和 其 概率 值 
eqi = np.array([[0,9,0],[0,9.16,0]]) 
p1 = 0.01 


eq2 = np.array([[0.2, -0.26,0],[0.23,0.22,1.6]]) 
p2 = 0.07 


eq3 = np.array([[-0.15, 0.28, 0],[0.26,0.24,0.44]]) 
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p3 = 0.07 


eq4 = np.array([[0.85, 0.04, 0],[-0.04, 0.85, 1.6]]) 
p4 = 0.85 


def ifs(p, eg, init, n): 


进行 图 数 和 迭代 

p: 每 个 函数 的 选择 概率 列表 
eq: ARERR 

init: 迭代 初始 点 

n: 迭代 次 数 


返回 值 : 每 次 迭代 所 得 的 X 坐 标 数组 ， Y 坐 标 数组 ， 计算 所 用 的 画 数 下 标 


# 和 迭代 向 量 的 初始 化 
pos = np.ones(3, dtype=np.float) 
pos[:2] = init 


# NS, i+ BAA eS 

p = np.add.accumulate(p) 

rands = np.random.rand(n) 

select = np.ones(n, dtype=np.int)*(n-1) 

for i, X in enumerate(p[::-1]): 
select[rands<x] = len(p)-i-1 


# 结果 的 初始 化 
result = np.zeros((n,2), dtype=np.float) 
c = np.zeros(n, dtype=np. float ) 


for i in xrange(n): 
eqidx = select[i] # 所 选 的 函数 下 标 
tmp = np.dot(eq[eqidx], pos) # 进行 迭代 
pos[:2] = tmp # 更 新 迭代 向 量 


# 保存 结 
result[i] = tmp 
c[i] = eqidx 


return result[:,0], result[:, 1], c 


start = time.clock() 

x, Y, © = ifs([p1,p2,p3,p4], [eqi, eq2,eq3,eq4], [0,0], 100000) 
print time.clock() - start 

pl.figure(figsize=(6,6)) 

pl.subplot(121) 

pl.scatter(x, y, s=1, c="g", marker="s", linewidths=0) 
pl.axis("equal") 

pl.axis("off") 

pl.subplot(122) 

pl.scatter(x, y, s=1,c = c, marker="s", linewidths=0) 
pl.axis("equal") 


pl.axis("off") 
pl.subplots_adjust(left=0, right=1, bottom=0, top=1,wspace=0, hspace=0' 
pl.gcf().patch.set_facecolor ("white") 

pl.show( ) 


‘| | 
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# -*- coding: utf-8 -*- 

from enthought.traits.ui.api import * 

from enthought.traits.ui.menu import OKCancelButtons 
from enthought.traits.api import * 

from enthought.traits.ui.wx.editor import Editor 


import matplotlib 

# matp1Lot1ib 采 用 WXAgg 为 后 台 ， 这 样 才 能 将 绘图 控件 佬 入 以 wx 为 后 台 界 面 库 的 traits 
matplotlib.use("WxXAgg" ) 

from matplotlib.backends.backend_wxagg import FigureCanvaswWxAgg as 
from matplotlib.figure import Figure 


import numpy as np 
import thread 
import time 

import wx 

import pickle 


ITER_COUNT = 4000 # —RifsskKKH RR 
ITER_TIMES = 10 # 总 共 调 用 ifs 的 次 数 


def triangle_area(triangle): 


计算 三 角形 的 面积 

triangle[0] 

triangle[1] 

Tees [2] 

AB = A-B 

AC = A-C 

return np.abs(np.cross(AB, AC) )/2.0 


QOw > 
Hou ul 


def solve_eq(triangle1, triangle2): 
解 方程 ， 从 triang1le1 变 换 到 triangle2 的 变换 系数 
triangle1, 2 是 二 维 数组 : 


x0, yO 

x1,y1 

x2,y2 
x0, yO = triangle1[0] 
x1,y1 = triangle1[1] 
x2,y2 = triangle1[2] 
a = np.zeros((6,6), dtype=np.float ) 
b = triangle2.reshape(-1) 
a[0, 0:3] = x0,y0,1 
a[1, 3:6] = x0,y0,1 
aay Ose) Sead a. a 
a[3, 3:6] = x1,y1,1 
a[4, 0:3] = x2,y2,1 
a[5, 3:6] = x2,y2,1 


c = np.linalg.solve(a, b) 
c.shape = (2,3) 
return c 


def ifs(p, eq, init, n): 
PETRA 

p: 每 个 函数 的 选择 概率 列表 
eq: ERKAK 

init: RHIA 

n: JERR 


返回 值 : 每 次 迭代 所 得 的 X 坐 标 数组 ， Y 坐 标 数组 ， 7+ SARA BAe 


# 和 迭代 向 量 的 初始 化 
pos = np.ones(3, dtype=np. float) 
pos[:2] = init 


# A WAS, + RANKS 
p = np.add.accumulate(p) 
rands = np.random.rand(n) 


select = np.ones(n, dtype=np.int)*(n-1) 
for i, X in enumerate(p[::-1]): 
select[rands<x] = len(p)-i-1 


# 结果 的 初始 化 
result = np.zeros((n,2), dtype=np. float) 
c = np.zeros(n, dtype=np. float) 


for i in xrange(n): 
eqidx = select[i] # Fe AENA Bae 
tmp = np.dot(eq[eqidx], pos) # 进行 迭代 
pos[:2] = tmp # 更 新 迭代 向 量 


# 保存 结 
result[i] = tmp 
c[i] = eqidx 


return result[:,0], result[:, 1], c 


class _MPLFigureEditor(Editor): 


使 用 matplotlib figure 的 traits 编 辑 器 


scrollable = True 


def init(self, parent): 
self.control = self._create_canvas(parent) 


def update_editor(self): 
pass 


def _create_canvas(self, parent): 
panel = wx.Panel(parent, -1, style=wx.CLIP_CHILDREN) 
sizer = wx.BoxSizer(wx.VERTICAL) 
panel.SetSizer(sizer ) 
mpl_control = FigureCanvas(panel, -1, self.value) 
sizer.Add(mpl_control, 1, wx.LEFT | wx.TOP | wx.GROW) 
self .value.canvas.SetMinSize((10,10) ) 
return panel 


class MPLFigureEditor(BasicEditorFactory): 


相当 于 traits .ui 中 的 EditorFactory， 它 返回 真正 创建 控件 的 类 


klass = _MPLFigureEditor 


class IFSTriangles(HasTraits): 


三 角形 编辑 器 


version = Int(0) # 三 角形 更 新 标志 


def _init (self, ax): 


super(IFSTriangles, self). _init_ () 


self.colors = [Ol GD Gn dared casa | 
self.points = np.array([(0,0), (2,0), (2,4), (0,1), (1,1), (1,3. 


self.equations = self.get_eqs() 


self.ax = ax 

self .ax.set_ylim(-10,10) 
self .ax.set_xlim(-10,10) 
Canvas = ax.figure.canvas 
# ¥EcanvasM Eats St 


canvas.mpl_connect('button_press_event', self.button_press_ 


Ccanvas.mpl_connect('button_release_event', 
canvas.mpl_connect('motion_notify_event', 


self.canvas = canvas 
self._ind = None 
self.background = None 
self .update_lines() 


def refresh(self): 


重新 绘制 所 有 的 三 角形 
self .update_lines() 
self .canvas.draw() 
self.version += 1 


def del_triangle(self): 


删除 最 后 一 个 三 角形 


self.points = self.points[:-3].copy() 


self.refresh() 


def add_triangle(self): 


添加 一 个 三 角 形 


self.points = np.vstack((self.points, 


self.refresh() 


def set_points(self, points): 


直接 设置 三 角形 定点 
self.points = points.copy() 
self.refresh() 


def get_eqs(self): 


计算 所 有 的 优 射 方程 


eqs = [] 


for i in range(1,len(self.points)/3): 


self .button_rele 
self.motion_notit 


np.array([(0,0), (1,9 


eqs.append( solve_eq( self.points[:3,:], self.points[i’ 


return eqs 


def get_areas(self): 


通过 三 角形 的 面积 计算 仿 射 方程 的 迭代 概率 
areas = [] 
for i in range(1, len(self.points)/3): 
areas.append( triangle_area(self.points[i*3:1*3+3,:]) ` 
s = sum(areas) 
return [x/s for x in areas] 


def update_lines(self): 


重新 绘制 所 有 的 三 角形 
del self.ax.lines[:] 
for i in xrange(0,len(self.points),3): 
color = self.colors[i/3%len(self.colors) ] 
x0, x1, x2 = self.points[i:i+3, 0] 
yO, y1, y2 = self.points[1i:i+3, 1] 
type = color+"%so" 
if i==0: 
linewidth 
else: 
linewidth = 1 
self.ax.plot([x0,x1],[y0,y1], type % "-", linewidth=1lir 
self.ax.plot([x1,x2],[y1,y2], type % "--", linewidth=1: 
self .ax.plot([x0,x2],[y0,y2], type % ":", linewidth=1lir 
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self .ax.set_ylim(-10,10) 
self .ax.set_xlim(-10,10) 


def button_release_callback(self, event): 


鼠标 按键 松 开 事件 


self. ind = None 


def button_press_callback(self, event): 


鼠标 按键 按 下 事件 
if event.inaxes!=self.ax: return 
if event.button != 1: return 
self._ind = self.get_ind_under_point(event.xdata, event. ydé 


def get_ind_under_point(self, mx, my): 


找到 距离 nx， my 最 近 的 顶点 
for i, p in enumerate(self.points): 
if abs(mx-p[0]) < 0.5 and abs(my-p[1])< 0.5: 


return i 
return None 


def motion_notify_callback(self, event): 


鼠标 移动 事件 
self.event = event 
if self._ind is None: return 
if event.inaxes != self.ax: return 
if event.button != 1: return 
x,y = event.xdata, event.ydata 


# 更 新 定点 坐标 
self.points[self._ind,:] = [x, y] 


i = self._ind / 3 * 3 

# 更 新 顶点 对 应 的 三 角形 线段 

xO, x1, x2 = self.points[i:i+3, 0] 

yO, yi, y2 = self.points[i:i+3, 1] 

self .ax.lines[i].set_data([x0, x1], [y0,y1]) 
self .ax.lines[i+1].set_data([x1, x2], [y1,y2]) 
self .ax.lines[i+2].set_data([x0,x2],[y0,y2]) 


# 背景 为 空 时 ， 捕 捉 背 景 
if self.background == None: 
self .ax.clear() 
self .ax.set_axis_off() 
self .canvas.draw() 
self.background = self.canvas.copy_from_bbox(self.ax.bl 
self .update_lines() 


# 快速 绘制 所 有 三 角形 
self.canvas.restore_region(self.background) # 恢 复 背 景 
# 绘制 所 有 三 角形 
for line in self.ax.lines: 

self .ax.draw_artist(line) 
self.canvas.blit(self.ax.bbox) 


self.version += 1 


class AskName(HasTraits): 
name = Str("") 
view = View( 
Item("name", label = u" 名 称 " )， 
kind = "modal", 
buttons = OKCancelButtons 


) 


class IFSHandler(Handler): 


在 界面 显示 之 前 需要 初始 化 的 内 容 


def init(self, info): 
info.object.init_gui_component() 
return True 


class IFSDesigner(HasTraits): 
figure = Instance(Figure) # 控制 绘图 控件 的 Figure 对 象 
ifs_triangle = Instance(IFSTriangles) 


add_button = Button(u" 添 加 三 角形 ") 
del_button = Button(u" 删 除 三 角形 ") 


save_button = Button(u" 保 存 当 前 IFS") 
unsave_button = Button(u" 删 除 当 前 IFS" ) 
clear = Bool(True) 

exit = Bool(False) 

ifs_names = List() 

ifs_points = List() 

current_name = Str 


view = View( 
VGroup( 
HGroup( 

Item("add_button"), 
Item("del_ button"), 
Item("current_name", editor = EnumEditor(name="obje 
Item("save_button"), 
Item("unsave_button"), 
show_labels = False 


), 
Item("figure", editor=MPLFigureEditor(), show_label=Fa- 


), 

resizable = True, 

height = 350, 

width = 600, 

title = uU"SAKRBARARiZ+", 
handler = IFSHandler() 


) 


def _current_name_changed(self): 
self .ifs_triangle.set_points( self.ifs_points[ self.ifs_nar 


def _add_button_fired(self): 
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self.ifs_triangle.add_triangle() 


def _del_button_fired(self): 
self.ifs_triangle.del_triangle() 


def _unsave_button_fired(self): 
if self.current_name in self.ifs_names: 
index = self.ifs_names.index(self.current_name) 
del self.ifs_names[index] 
del self.ifs_points[index ] 


self .save_data() 


def _save_button_fired(self): 


保存 按钮 义理 
ask = AskName(name = self.current_name) 
if ask.configure_traits(): 
if ask.name not in self.ifs_names: 
self.ifs_names.append( ask.name ) 
self.ifs_points.append( self.ifs_triangle.points.cc 
else: 
index = self.ifs_names.index(ask.name) 
self.ifs_names[index] = ask.name 
self.ifs_points[index] = self.ifs_triangle.points.<¢ 
self.save_data() 


def save_data(self): 
with file("IFS.data", "wb") as f: 
pickle.dump(self.ifs_names[:], f) # ifs_names#zlist, | 
for data in self.ifs_points: 
np.save(f, data) # 保存 多 个 数组 


def ifs_calculate(self): 


在 别 的 线程 中 计算 
def draw_points(x, y, c): 
if len(self.ax2.collections) < ITER_TIMES: 

try: 
self.ax2.scatter(x, y, s=1, c=c, marker="s", 1: 
self .ax2.set_axis_off() 
self .ax2.axis("equal") 
self .figure.canvas.draw() 

except: 
pass 


def clear_points(): 
self .ax2.clear() 


while 1: 
try: 
if self.exit == True: 
break 
if self.clear == True: 


self.clear = False 

self.initpos = [0, 0] 

# 不 绘制 迭代 的 初始 100 个 点 

x, y, C = ifs( self.ifs_triangle.get_areas(), : 
self.initpos = [x[-1], y[-1]] 

self.ax2.clear() 


x, y, c = ifs( self.ifs_triangle.get_areas(), self 


if np.max(np.abs(x)) < 1000000 and np.max(np.abs(y: 
self.initpos = [x[-1], y[-1]] 
wx.CallAfter( draw_points, x, y, c ) 
time.sleep(0.05) 
except: 
pass 


@on_trait_change("ifs_triangle.version") 
def on_ifs_version_changed(self): 


当 三 角形 更 新 时 ， 重 新 绘制 所 有 的 迭代 点 


self.clear = True 


def _figure_default(self): 


figure 属 性 的 缺 省 值 ， 直 接 创 建 一 个 Figure 对 象 
figure = Figure() 
self.ax = figure.add_subplot(121) 
self.ax2 = figure.add_subplot(122) 
self.ax2.set_axis_off() 
self.ax.set_axis_off() 
figure.subplots_adjust(left=0, right=1, bottom=0, top=1, wspace 
figure.patch.set_facecolor("w") 
return figure 


def init_gui_component (self): 
self.ifs_triangle = IFSTriangles(self.ax) 
self .figure.canvas.draw() 
thread.start_new_thread( self.ifs_calculate, ()) 


try: 
with file("ifs.data","rb") as f: 
self.ifs_names = pickle. load(f) 
self.ifs_points = [] 
for i in xrange(len(self.ifs_names) ): 
self.ifs_points.append(np.load(f) ) 
if len(self.ifs_names) > 0: 
self.current_name = self.ifs_names|[ -1] 
except: 


pass 


designer = IFSDesigner( ) 
designer .configure_traits() 
designer.exit = True 


SSS 





绘制 L-System 的 分 形 


相关 文档 : L-System 分 形 





# -*- coding: utf-8 -*- 

#L-System(Lindenmayer system) 是 一 种 用 字符 串 蔡 代 产生 分 形 图 形 的 算法 
from math import sin, cos, pi 

import matplotlib.pyplot as pl 

from matplotlib import collections 


class L_System(object): 
def _init__(self, rule): 
info = rule['S'] 
for i in range(rule['iter']): 
ninfo = [] 
for c in info: 
if c in rule: 
ninfo.append(rule[c] ) 


else: 
ninfo.append(c) 
info = "".join(ninfo) 
self.rule = rule 
self.info = info 


def get_lines(self): 
d = self.rule['direct' ] 


rules 


self.rule['angle' ] 
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for c in self.info: 
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lines.append(((p[9], 
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p[1] + l*sin(r) 


stack.append((p,d) ) 


elif c == "j": 
p, d = stack[-1] 
del stack[-1] 
return lines 
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draw(ax, rule, iter=None): 
if iter!=None: 

rule["iter"] = iter 
lines = L_System(rule).get_lines() 
linecollections = collections.LineCollection(lines) 
ax.add_collection(linecollections, autolim=True) 
ax.axis("equal") 
ax.set_axis_off() 
ax.set_xlim(ax.dataLim.xmin, ax.dataLim.xmax) 
ax.invert_yaxis() 


= pl.figure(figsize=(7,4.5)) 
patch.set_facecolor("w") 


i in xrange(6): 
ax = fig.add_subplot(231+1i) 
draw(ax, rules[i]) 


subplots_adjust(left=0, right=1, bottom=0, top=1, wspace=0, hspace=( 


pl.show( ) 





